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: 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