RESTWebsocketsamberLensAWS S3SnowflakeGoogle BigQueryAsset Reference & Classification
API Documentation

Reference

get https://api.amberdata.com/markets/futures/exchanges/reference

Provides comprehensive reference data for futures instruments across exchanges, including details on base and quote symbols, price and volume limits, precision, contract terms, and trading availability.

⚠️ IMPORTANT UPDATE ⚠️

⚠️

Important Update

The old endpoint https://api.amberdata.com/market/futures/exchanges/reference has been updated to https://api.amberdata.com/markets/futures/exchanges/reference 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/reference
    • New: https://api.amberdata.com/markets/futures/exchanges/reference
  • 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 information
  • Field Value Changes:
    • exchange: New field
    • instrument: New field
    • market: New field
    • exchangeEnabled: Replaces active
    • limitsPriceMin: Replaces limits_price_min
    • limitsPriceMax: Replaces limits_price_max
    • limitsVolumeMin: Replaces limits_amount_min
    • limitsVolumeMax: Replaces limits_amount_max
    • limitsMarketMin: Replaces limits_market_min
    • limitsMarketMax: Replaces limits_market_max
    • limitsLeverageMin: Replaces limits_leverage_min
    • limitsLeverageMax: Replaces limits_leverage_max
    • limitsLeverageSuperMax: New field
    • limitsCostMin: Replaces limits_cost_min
    • limitsCostMax: Replaces limits_cost_max
    • precisionVolume: Replaces precision_amount
    • listingTimestamp: New field
    • contractUnderlying: Replaces underlying
    • contractExpirationTimestamp: Replaces expiration
    • contractPeriod: Replaces contractType
    • contractSettleType: Replaces marginType
    • contractSettleSymbol: Replaces settleAsset
  • Other
    • Include the Accept-Encoding: header in your API requests to take advantage of compressed responses.

🚧

precision_amount

Occasionally, you may encounter a value of 0 for precision_amount. This is due to the underlying exchange returning 0 for the instrument's trade size precision.

We have noticed this behavior with several instruments on Kraken.

RESPONSE DATA (click to expand)
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[].baseSymbolstringThe base currency symbol (e.g., 1000BONK).
payload.data[].quoteSymbolstringThe quote currency symbol (e.g., USDC).
payload.data[].marketstringThe market type (e.g., futures).
payload.data[].exchangeEnabledbooleanIndicates whether trading is enabled for this instrument on the exchange.
payload.data[].limitsPriceMinfloatThe minimum allowed price for trading this instrument.
payload.data[].limitsPriceMaxfloatThe maximum allowed price for trading this instrument.
payload.data[].limitsVolumeMinfloatThe minimum allowed trade volume for this instrument.
payload.data[].limitsVolumeMaxfloatThe maximum allowed trade volume for this instrument.
payload.data[].limitsMarketMinfloatThe minimum allowed market order volume for this instrument.
payload.data[].limitsMarketMaxfloatThe maximum allowed market order volume for this instrument.
payload.data[].limitsLeverageMinfloatThe minimum allowed leverage for this instrument.
payload.data[].limitsLeverageMaxfloatThe maximum allowed leverage for this instrument.
payload.data[].limitsLeverageSuperMaxfloatThe maximum allowed leverage for super users or advanced traders (if applicable).
payload.data[].limitsCostMinfloatThe minimum allowed cost for trading this instrument.
payload.data[].limitsCostMaxfloatThe maximum allowed cost for trading this instrument.
payload.data[].precisionPricefloatThe price precision (number of decimal places) for this instrument.
payload.data[].precisionVolumefloatThe volume precision (number of decimal places) for this instrument.
payload.data[].precisionBasefloatThe base asset precision for this instrument.
payload.data[].precisionQuotefloatThe quote asset precision for this instrument.
payload.data[].listingTimestampintegerThe timestamp when the instrument was listed on the exchange (nullable if not applicable).
payload.data[].contractUnderlyingstringThe underlying asset for futures contracts (e.g., 1000BONK).
payload.data[].contractExpirationTimestampintegerThe expiration timestamp for the contract (nullable if perpetual).
payload.data[].contractPeriodstringThe contract period (e.g., perpetual, quarterly).
payload.data[].contractSizefloatThe contract size for futures contracts (nullable if not applicable).
payload.data[].contractSettleTypestringThe settlement type for the contract (e.g., linear, inverse).
payload.data[].contractSettleSymbolstringThe settlement currency symbol (nullable if not applicable).
Language
Credentials
Header
Click Try It! to start a request and see the response here!