Instruments

Provides detailed metadata and trading activity timelines for futures instruments across exchanges, including funding rates, liquidations, long/short ratios, OHLCV, open interest, order book snapshots and events, ticker updates, and trade history.

⚠️ IMPORTANT UPDATE ⚠️

⚠️

Important Update

The old endpoint https://api.amberdata.com/market/futures/exchanges/information has been updated to https://api.amberdata.com/markets/futures/exchanges/information and is no longer being supported. Please update your integrations accordingly.

See changes here
  • Endpoint URL Change:
    • Old: https://api.amberdata.com/market/futures/exchanges/information
    • New: https://api.amberdata.com/markets/futures/exchanges/information
  • Metadata Changes:
    • api-version field added to the response
  • Data Structure Changes:
    • The old schema data structure was a nested JSON object with exchanges and instruments
    • The new schema data structure is an array of JSON objects, each representing an exchange and instrument with detailed date ranges for different data types
  • Field Value Changes:
    • fundingRate: Replaces funding_rate
    • openInterest: Replaces open_interest
    • liquidation: Replaces liquidation_order
    • longShortRatio: Replaces long_short_ratio
    • orderBookEvent: Replaces order_book_event
    • orderBookSnapshot: Replaces order_book_snapshot
  • Other
    • Include the Accept-Encoding: header in your API requests to take advantage of compressed responses.
    • includeDates parameter is no longer supported as dates are always provided

❗️

exchange=cme

CME is currently not supported for this endpoint. It will be added soon

RESPONSE DATA
FieldTypeDescription
payload.metadata.nextstringThe URL for the next page of data (for pagination purposes).
payload.metadata.api-versionstringThe version of the API used for this request.
payload.data[].exchangestringThe name of the exchange (e.g., binance).
payload.data[].instrumentstringThe trading instrument or pair (e.g., 1000BONKUSDC).
payload.data[].{feature}objectA placeholder representing one of the feature types (e.g., trade, ticker, fundingRate, ohlcv).
payload.data[].{feature}.startDateintegerStart date of the specified feature (e.g., trade, ticker, fundingRate) in milliseconds since epoch.
payload.data[].{feature}.endDateintegerEnd date of the specified feature (e.g., trade, ticker, fundingRate) in milliseconds since epoch.
payload.data[].activebooleanIndicates whether the instrument is active (true) or inactive (false) - only available when includeInactive=true.
Language
Credentials
Header
Click Try It! to start a request and see the response here!