Amberdata Options API

Options market data and volatility analytics (implied volatility, Greeks, surfaces, term structures).

Operations 21

GET /options/exchanges/information Instruments #
GET /options/exchanges/reference Reference #
GET /options/liquidations/information Information #
GET /options/liquidations/{instrument} Historical #
GET /options/ohlcv/information Information #
GET /options/ohlcv/{instrument} Historical #
GET /options/batch-ohlcv/{exchange} Batch Historical #
GET /options/open-interest/information Information #
GET /options/open-interest/{instrument} Historical #
GET /options/batch-open-interest/{exchange} Batch Historical #
GET /options/order-book-events/information Events Information #
GET /options/order-book-events/{instrument} Events Historical #
GET /options/order-book-snapshots/information Snapshots Information #
GET /options/order-book-snapshots/{instrument} Snapshots Historical #
GET /options/tickers/information Information #
GET /options/tickers/{instrument} Historical #
GET /options/trades/information Information #
GET /options/trades/{instrument} Historical #
GET /markets/options/exchanges/reference Options instruments and reference #
GET /markets/options/trades/{instrument} Options trades #
GET /markets/options/order-book-snapshots/{instrument} Options order book snapshots #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/amberdata-options-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

amberdata-options-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Amberdata Options API
  version: '1.0'
  description: 'Operations tagged Options across 2 of this provider''s published API definitions: amberdata-market-openapi.yaml, amberdata-options-api-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.amberdata.com/markets
- url: https://api.amberdata.com
  description: Amberdata REST API
tags:
- name: Options
paths:
  /options/exchanges/information:
    get:
      summary: Instruments
      description: Provides metadata for available options contracts on supported exchanges, including exchange names, contract symbols, and data types (Order Book Events, Ticker, Trades, etc.) with associated data coverage periods.
      operationId: options-exchanges-pairs
      parameters:
      - name: exchange
        in: query
        description: '**[Optional]** Only return data for the given exchange(s) (comma separated)'
        schema:
          type: string
          default: deribit
      - name: instrument
        in: query
        description: Only return data for the given pair.
        schema:
          type: string
      - name: includeInactive
        in: query
        description: '**[Optional]** If true, endpoint returns all instruments, including delisted ones. **[Defaults]** `True | False*`.'
        schema:
          type: boolean
      - name: timeFormat
        in: query
        description: '**[Optional]** Time format of the timestamps in the return payload. **[Defaults]** `milliseconds | ms* | iso | iso8601 | hr | human_readable`'
        schema:
          type: string
      - name: size
        in: query
        description: '**[Optional]** The number of records per page (only available when `includeInactive=true`).'
        schema:
          type: integer
          format: int32
      - name: Accept-Encoding
        in: header
        required: true
        description: ''
        schema:
          type: string
          default: gzip, deflate, br
      - name: api-version
        in: header
        schema:
          type: string
      responses:
        '200':
          description: '200'
          content:
            application/json:
              examples:
                Success:
                  value:
                    status: 200
                    title: OK
                    description: Successful request
                    payload:
                      metadata:
                        next: https://api.amberdata.com/markets/options/exchanges/information?cursor=N4IglgdgxgNgrgEwKYEkIEMoBcwDckgBcAZujAM5IA0408yAqhOXAA6sD2ATlkggKIAPKAAt0EAOZJyRUhWogcAWyQAxbkvRYiIJWBgwwlKBwgIZNYhq06AVuVMgardFKIBGGuTAAvAoQBWAAYggF8gA
                        api-version: '2023-09-30'
                      data:
                      - exchange: bybit
                        instrument: BTC-16AUG24-50000-C
                        openInterest:
                          startDate: 1721895646123
                          endDate: 1722297559023
                        orderBookSnapshot:
                          startDate: 1721895180679
                          endDate: 1722370735780
                        orderBookEvent:
                          startDate: 1721899231080
                          endDate: 1721946070781
                        ticker:
                          startDate: 1721895381123
                          endDate: 1722370799223
              schema:
                oneOf:
                - title: Success
                  type: object
                  properties:
                    status:
                      type: integer
                      example: 200
                      default: 0
                    title:
                      type: string
                      example: OK
                    description:
                      type: string
                      example: Successful request
                    payload:
                      type: object
                      properties:
                        metadata:
                          type: object
                          properties:
                            next:
                              type: string
                              example: https://api.amberdata.com/markets/options/exchanges/information?cursor=N4IglgdgxgNgrgEwKYEkIEMoBcwDckgBcAZujAM5IA0408yAqhOXAA6sD2ATlkggKIAPKAAt0EAOZJyRUhWogcAWyQAxbkvRYiIJWBgwwlKBwgIZNYhq06AVuVMgardFKIBGGuTAAvAoQBWAAYggF8gA
                            api-version:
                              type: string
                              example: '2023-09-30'
                        data:
                          type: array
                          items:
                            type: object
                            properties:
                              exchange:
                                type: string
                                example: bybit
                              instrument:
                                type: string
                                example: BTC-16AUG24-50000-C
                              openInterest:
                                type: object
                                properties:
                                  startDate:
                                    type: integer
                                    example: 1721895646123
                                    default: 0
                                  endDate:
                                    type: integer
                                    example: 1722297559023
                                    default: 0
                              orderBookSnapshot:
                                type: object
                                properties:
                                  startDate:
                                    type: integer
                                    example: 1721895180679
                                    default: 0
                                  endDate:
                                    type: integer
                                    example: 1722370735780
                                    default: 0
                              orderBookEvent:
                                type: object
                                properties:
                                  startDate:
                                    type: integer
                                    example: 1721899231080
                                    default: 0
                                  endDate:
                                    type: integer
                                    example: 1721946070781
                                    default: 0
                              ticker:
                                type: object
                                properties:
                                  startDate:
                                    type: integer
                                    example: 1721895381123
                                    default: 0
                                  endDate:
                                    type: integer
                                    example: 1722370799223
                                    default: 0
      deprecated: false
      tags:
      - Options
      security:
      - ApiKeyAuth: []
    servers:
    - url: https://api.amberdata.com/markets
  /options/exchanges/reference:
    get:
      summary: Reference
      description: Provides essential reference details for options contracts on supported exchanges, including contract symbols, underlying assets, strike prices, expiration dates, settlement types, price and volume limits, and precision requirements.
      operationId: options-exchanges-reference
      parameters:
      - name: exchange
        in: query
        description: '**[Optional]** Only return data for the given exchange(s) (comma separated)'
        schema:
          type: string
      - name: instrument
        in: query
        description: Only return data for the given pair.
        schema:
          type: string
      - name: includeInactive
        in: query
        description: '**[Optional]** If true, endpoint returns all instruments, including delisted ones. **[Defaults]** `True | False*`.'
        schema:
          type: boolean
      - name: size
        in: query
        description: '**[Optional]** The number of records per page (only available when `includeInactive=true`).'
        schema:
          type: integer
          format: int32
      - name: startDate
        in: query
        description: '**[Optional]** Payload only includes instruments which have expiration after this date (inclusive). **[Formats]** `seconds | milliseconds | iso8601` **[Examples]** `1578531600 | 1578531600000 | 2020-09-01T01:00:00`'
        schema:
          type: string
          format: date-time
      - name: endDate
        in: query
        description: '**[Optional]** Payload only includes instruments which have expiration before this date (exclusive). **[Formats]** `seconds | milliseconds | iso8601` **[Examples]** `1578531600 | 1578531600000 | 2020-09-01T01:00:00`'
        schema:
          type: string
          format: date-time
      - name: includeOriginalReference
        in: query
        description: '**[Optional]** If true, endpoint returns originalReference. **[Defaults]** `True | False*`.'
        schema:
          type: boolean
      - name: timeFormat
        in: query
        description: '**[Optional]** Time format of the timestamps in the return payload. **[Defaults]** `milliseconds | ms* | iso | iso8601 | hr | human_readable`'
        schema:
          type: string
      - name: Accept-Encoding
        in: header
        required: true
        description: ''
        schema:
          type: string
          default: gzip, deflate, br
      - name: api-version
        in: header
        schema:
          type: string
      responses:
        '200':
          description: '200'
          content:
            application/json:
              examples:
                Success:
                  value:
                    status: 200
                    title: OK
                    description: Successful request
                    payload:
                      metadata:
                        next: https://api.amberdata.com/markets/options/exchanges/reference?cursor=N4IglgdgxgNgrgEwKYEkIEMoBcwDckgBcAZujAM5IA0408yA8gE5gDmkZASksUk0tAIkylGpFiIkAVQjk4AB3kB7JliQIAogA8oAC3QRWSckVIVqIHAFskAMRVX0WIiCtgYMMJShKICEzTEDk4uAFbkviA08uhGRACMNORgAF5CAKwADJkAvkA
                        api-version: '2023-09-30'
                      data:
                      - exchange: bybit
                        instrument: BTC-16AUG24-50000-C
                        baseSymbol: BTC
                        quoteSymbol: USDC
                        market: options
                        exchangeEnabled: true
                        limitsPriceMin: 5
                        limitsPriceMax: 10000000
                        limitsVolumeMin: null
                        limitsVolumeMax: null
                        limitsMarketMin: 0.01
                        limitsMarketMax: 500
                        limitsLeverageMin: null
                        limitsLeverageMax: null
                        limitsLeverageSuperMax: null
                        limitsCostMin: null
                        limitsCostMax: null
                        precisionPrice: 5
                        precisionVolume: 0.01
                        precisionBase: null
                        precisionQuote: null
                        listingTimestamp: 1721894400000
                        contractUnderlying: BTC
                        contractExpirationTimestamp: 1723795200000
                        contractPeriod: weekly
                        contractSize: null
                        contractSettleType: option
                        contractSettleSymbol: USDC
                        optionType: call
                        optionStrikePrice: 50000
              schema:
                oneOf:
                - title: Success
                  type: object
                  properties:
                    status:
                      type: integer
                      example: 200
                      default: 0
                    title:
                      type: string
                      example: OK
                    description:
                      type: string
                      example: Successful request
                    payload:
                      type: object
                      properties:
                        metadata:
                          type: object
                          properties:
                            next:
                              type: string
                              example: https://api.amberdata.com/markets/options/exchanges/reference?cursor=N4IglgdgxgNgrgEwKYEkIEMoBcwDckgBcAZujAM5IA0408yA8gE5gDmkZASksUk0tAIkylGpFiIkAVQjk4AB3kB7JliQIAogA8oAC3QRWSckVIVqIHAFskAMRVX0WIiCtgYMMJShKICEzTEDk4uAFbkviA08uhGRACMNORgAF5CAKwADJkAvkA
                            api-version:
                              type: string
                              example: '2023-09-30'
                        data:
                          type: array
                          items:
                            type: object
                            properties:
                              exchange:
                                type: string
                                example: bybit
                              instrument:
                                type: string
                                example: BTC-16AUG24-50000-C
                              baseSymbol:
                                type: string
                                example: BTC
                              quoteSymbol:
                                type: string
                                example: USDC
                              market:
                                type: string
                                example: options
                              exchangeEnabled:
                                type: boolean
                                example: true
                                default: true
                              limitsPriceMin:
                                type: integer
                                example: 5
                                default: 0
                              limitsPriceMax:
                                type: integer
                                example: 10000000
                                default: 0
                              limitsVolumeMin: {}
                              limitsVolumeMax: {}
                              limitsMarketMin:
                                type: number
                                example: 0.01
                                default: 0
                              limitsMarketMax:
                                type: integer
                                example: 500
                                default: 0
                              limitsLeverageMin: {}
                              limitsLeverageMax: {}
                              limitsLeverageSuperMax: {}
                              limitsCostMin: {}
                              limitsCostMax: {}
                              precisionPrice:
                                type: integer
                                example: 5
                                default: 0
                              precisionVolume:
                                type: number
                                example: 0.01
                                default: 0
                              precisionBase: {}
                              precisionQuote: {}
                              listingTimestamp:
                                type: integer
                                example: 1721894400000
                                default: 0
                              contractUnderlying:
                                type: string
                                example: BTC
                              contractExpirationTimestamp:
                                type: integer
                                example: 1723795200000
                                default: 0
                              contractPeriod:
                                type: string
                                example: weekly
                              contractSize: {}
                              contractSettleType:
                                type: string
                                example: option
                              contractSettleSymbol:
                                type: string
                                example: USDC
                              optionType:
                                type: string
                                example: call
                              optionStrikePrice:
                                type: integer
                                example: 50000
                                default: 0
      deprecated: false
      tags:
      - Options
      security:
      - ApiKeyAuth: []
    servers:
    - url: https://api.amberdata.com/markets
  /options/liquidations/information:
    get:
      summary: Information
      description: Provides availability details for options contract liquidation data across supported exchanges, including contract symbols, underlying assets, and data coverage periods for tracking liquidation events.
      operationId: options-liquidations-information
      parameters:
      - name: exchange
        in: query
        description: '**[Optional]** The exchange(s) for which to retrieve the most current data (comma separated). **[Default]** All available exchanges.'
        schema:
          type: string
      - name: instrument
        in: query
        description: Only return data for the given pair.
        schema:
          type: string
      - name: includeInactive
        in: query
        description: '**[Optional]** If true, endpoint returns all instruments, including delisted ones. **[Defaults]** `false* | true`'
        schema:
          type: boolean
      - name: timeFormat
        in: query
        description: '**[Optional]** Time format of the timestamps in the return payload. **[Defaults]** `milliseconds | ms* | iso | iso8601 | hr | human_readable`'
        schema:
          type: string
      - name: Accept-Encoding
        in: header
        required: true
        description: ''
        schema:
          type: string
          default: gzip, deflate, br
      - name: api-version
        in: header
        schema:
          type: string
      responses:
        '200':
          description: '200'
          content:
            application/json:
              examples:
                Success:
                  value:
                    status: 200
                    title: OK
                    description: Successful request
                    payload:
                      metadata:
                        next: https://api.amberdata.com/markets/options/liquidations/information?cursor=N4IglgdgxgNgrgEwKYEkIEMoBcwDckgBcAZujAM5IA0408yAqhOXAA6sD2ATlkggKIAPKAAt0EAOZJyRUhWogcAWyQAxbkvRYiIJWBgwwlKBwgIZNYhq06AVuVMgardFKIBGGuTAAvAoQBWAAYggF8gA
                        api-version: '2023-09-30'
                      data:
                      - exchange: deribit
                        instrument: BTC-10JUL24-55500-P
                        underlying: BTC
                        startDate: 1720581871000
                        endDate: 1720581871000
              schema:
                oneOf:
                - title: Success
                  type: object
                  properties:
                    status:
                      type: integer
                      example: 200
                      default: 0
                    title:
                      type: string
                      example: OK
                    description:
                      type: string
                      example: Successful request
                    payload:
                      type: object
                      properties:
                        metadata:
                          type: object
                          properties:
                            next:
                              type: string
                              example: https://api.amberdata.com/markets/options/liquidations/information?cursor=N4IglgdgxgNgrgEwKYEkIEMoBcwDckgBcAZujAM5IA0408yAqhOXAA6sD2ATlkggKIAPKAAt0EAOZJyRUhWogcAWyQAxbkvRYiIJWBgwwlKBwgIZNYhq06AVuVMgardFKIBGGuTAAvAoQBWAAYggF8gA
                            api-version:
                              type: string
                              example: '2023-09-30'
                        data:
                          type: array
                          items:
                            type: object
                            properties:
                              exchange:
                                type: string
                                example: deribit
                              instrument:
                                type: string
                                example: BTC-10JUL24-55500-P
                              underlying:
                                type: string
                                example: BTC
                              startDate:
                                type: integer
                                example: 1720581871000
                                default: 0
                              endDate:
                                type: integer
                                example: 1720581871000
                                default: 0
      deprecated: false
      tags:
      - Options
      security:
      - ApiKeyAuth: []
    servers:
    - url: https://api.amberdata.com/markets
  /options/liquidations/{instrument}:
    get:
      summary: Historical
      description: Provides historical liquidation data for options contracts, detailing liquidation actions, prices, volumes, mark and index prices, and buy/sell sides to track liquidation events over time across supported exchanges.
      operationId: options-liquidations-historical
      parameters:
      - name: instrument
        in: path
        description: The instrument for which to retrieve the requested data.
        schema:
          type: string
          default: BTC-27DEC24-100000-C
        required: true
      - name: exchange
        in: query
        description: The exchange(s) for which to retrieve the requested data (comma separated). **[Defaults]** All available exchanges.
        required: true
        schema:
          type: string
          default: deribit
      - name: startDate
        in: query
        description: '**[Optional]** Payload only includes data after this date (inclusive). **[Formats]** `seconds | milliseconds | iso8601` **[Examples]** `1578531600 | 1578531600000 | 2020-09-01T01:00:00`'
        schema:
          type: string
          format: date-time
          default: '1691321498000'
      - name: endDate
        in: query
        description: '**[Optional]** Payload only includes data before this date (exclusive). **[Formats]** `seconds | milliseconds | iso8601` **[Examples]** `1578531600 | 1578531600000 | 2020-09-01T01:00:00`'
        schema:
          type: string
          format: date-time
      - name: timeFormat
        in: query
        description: '**[Optional]** Time format of the timestamps in the return payload. **[Defaults]** `milliseconds | ms* | iso | iso8601 | hr | human_readable`'
        schema:
          type: string
      - name: sortDirection
        in: query
        description: '**[Optional]** Specifies the direction in which the data is sorted (by timestamp).   **[Defaults]** asc (ascending order).   **[Usage Conditions]** This parameter can only be used if the `startDate` and `endDate` timeframe is within the most recent 24 hours, or if the `startDate` and `endDate` parameters are not used at all.   **[Examples]** ascending | descending | asc | desc'
        schema:
          type: string
      - name: Accept-Encoding
        in: header
        required: true
        description: ''
        schema:
          type: string
          default: gzip, deflate, br
      - name: api-version
        in: header
        schema:
          type: string
      responses:
        '200':
          description: '200'
          content:
            application/json:
              examples:
                Success:
                  value:
                    status: 200
                    title: OK
                    description: Successful request
                    payload:
                      metadata:
                        next: null
                        api-version: '2023-09-30'
                      data:
                      - instrument: BTC-29DEC23-30000-C
                        exchange: deribit
                        exchangeTimestamp: 1691321498000
                        exchangeTimestampNanoseconds: 0
                        action: null
                        orderId: '262149185'
                        side: BUY
                        status: null
                        timeInForce: null
                        type: null
                        price: 0.0935
                        volume: 2
                        unit: base_asset
                        tickDirection: 2
                        markPrice: 0.09432956
                        indexPrice: 29033.78
              schema:
                oneOf:
                - title: Success
                  type: object
                  properties:
                    status:
                      type: integer
                      example: 200
                      default: 0
                    title:
                      type: string
                      example: OK
                    description:
                      type: string
                      example: Successful request
                    payload:
                      type: object
                      properties:
                        metadata:
                          type: object
                          properties:
                            next: {}
                            api-version:
                              type: string
                              example: '2023-09-30'
                        data:
                          type: array
                          items:
                            type: object
                            properties:
                              instrument:
                                type: string
                                example: BTC-29DEC23-30000-C
                              exchange:
                                type: string
                                example: deribit
                              exchangeTimestamp:
                                type: integer
                                example: 1691321498000
                                default: 0
                              exchangeTimestampNanoseconds:
                                type: integer
                                example: 0
                                default: 0
                              action: {}
                              orderId:
                                type: string
                                example: '262149185'
                              side:
                                type: string
                                example: BUY
                              status: {}
                              timeInForce: {}
                              type: {}
                              price:
                                type: number
                                example: 0.0935
                                default: 0
                              volume:
                                type: integer
                                example: 2
                                default: 0
                              unit:
                                type: string
                                example: base_asset
                              tickDirection:
                                type: integer
                                example: 2
                                default: 0
                              markPrice:
                                type: number
                                example: 0.09432956
                                default: 0
                              indexPrice:
                                type: number
                                example: 29033.78
                                default: 0
      deprecated: false
      tags:
      - Options
      security:
      - ApiKeyAuth: []
    servers:
    - url: https://api.amberdata.com/markets
  /options/ohlcv/information:
    get:
      summary: Information
      description: Provides availability details for OHLCV (Open, High, Low, Close, Volume) data on options contracts across supported exchanges, including contract symbols, underlying assets, and data coverage periods.
      operationId: options-ohlcv-information
      parameters:
      - name: exchange
        in: query
        description: '**[Optional]** The exchange(s) for which to retrieve the most current data (comma separated). **[Default]** All available exchanges.'
        schema:
          type: string
      - name: instrument
        in: query
        description: Only return data for the given pair.
        schema:
          type: string
      - name: includeInactive
        in: query
        description: '**[Optional]** If true, endpoint returns all instruments, including delisted ones. **[Defaults]** `True | False*`.'
        schema:
          type: boolean
      - name: timeInterval
        in: query
        description: '**[Optional]** Time interval. **[Defaults]** `minutes* | hours | days`'
        schema:
          type: string
      - name: timeFormat
        in: query
        description: '**[Optional]** Time format of the timestamps in the return payload. **[Defaults]** `milliseconds | ms* | iso | iso8601 | hr | human_readable`'
        schema:
          type: string
      - name: Accept-Encoding
        in: header
        required: true
        description: ''
        schema:
          type: string
          default: gzip, deflate, br
      - name: api-version
        in: header
        schema:
          type: string
      responses:
        '200':
          description: '200'
          content:
            application/json:
              examples:
                Success:
                  value:
                    status: 200
                    title: OK
                    description: Successful request
                    payload:
                      metadata:
                        next: https://api.amberdata.com/markets/options/ohlcv/information?cursor=N4IglgdgxgNgrgEwKYEkIEMoBcwDckgBcAZujAM5IA0408yAqhOXAA6sD2ATlkggKIAPKAAt0EAOZJyRUhWogcAW1QReXXGSKgMKoiAToAnjJrkAjjABy6PYQPGQZyzZUAFeFy33DYGEacDJFI4GCwiAGYARgA2ACY4gBYABlTUmiV0QSIYiKTEgA409JAYDg4AawAjTAq3JC4wDgQiOOSAXxokYXokKw4IABUvZBaSMkoaZSQAMW5M8PslPxgwSigBhFMQYnn0RZAAK3IBwNZ0KSIoszAALwJCAFZU9qA
                        api-version: '2023-09-30'
                      data:
                      - exchange: deribit
                        instrument: BTC-24JUL24-59000-C
                        underlying: BTC
                        startDate: null
                        endDate: null
              schema:
                oneOf:
                - title: Success
                  type: object
                  properties:
                    status:
                      type: integer
                      example: 200
                      default: 0
                    title:
                      type: string
                      example: OK
                    description:
                      type: string
                      example: Successful request
                    payload:
                      type: object
                      properties:
                        metadata:
                          type: object
                          properties:
                            next:
                              type: string
                              example: https://api.amberdata.com/markets/options/ohlcv/information?cursor=N4IglgdgxgNgrgEwKYEkIEMoBcwDckgBcAZujAM5IA0408yAqhOXAA6sD2ATlkggKIAPKAAt0EAOZJyRUhWogcAW1QReXXGSKgMKoiAToAnjJrkAjjABy6PYQPGQZyzZUAFeFy33DYGEacDJFI4GCwiAGYARgA2ACY4gBYABlTUmiV0QSIYiKTEgA409JAYDg4AawAjTAq3JC4wDgQiOOSAXxokYXokKw4IABUvZBaSMkoaZSQAM

# --- truncated at 32 KB (114 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/amberdata/refs/heads/main/openapi/amberdata-options-api-openapi.yml