Reference

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.

⚠️ IMPORTANT UPDATE ⚠️

⚠️

Important Update

The old endpoint https://api.amberdata.com/market/options/exchanges/reference has been updated to https://api.amberdata.com/markets/options/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/options/exchanges/reference
    • New: https://api.amberdata.com/markets/options/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: New field
    • limitsVolumeMin: Replaces limits_amount_min
    • limitsVolumeMax: New field
    • limitsMarketMin: New field
    • limitsMarketMax: New field
    • limitsLeverageMin: Replaces limits_leverage_min
    • limitsLeverageMax: Replaces limits_leverage_max
    • limitsLeverageSuperMax: New field
    • limitsCostMin: New field
    • limitsCostMax: New field
    • precisionVolume: Replaces precision_amount
    • precisionBase: New field
    • precisionQuote: New field
    • listingTimestamp: New field
    • contractUnderlying: Replaces underlying
    • contractExpirationTimestamp: Replaces expiration
    • contractPeriod: Replaces contractType
    • contractSettleType: Replaces marginType
    • contractSettleSymbol: Replaces settleAsset
    • optionStrikePrice: Replaces strikePrice
  • Other
    • Include the Accept-Encoding: header in your API requests to take advantage of compressed responses.

❗️

exchange=cme

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

RESPONSE DATA
FieldTypeDescription
payload.metadata.nextstringPagination
payload.data.{exchange}objectExchange object, contains a list of instruments supported by the exchange.
payload.data.{exchange}.{instrument}objectInstrument object, contains information about the instrument.
payload.data.{exchange}.{instrument}.contractTypestringContract type for instrument
payload.data.{exchange}.{instrument}.limits_price_minnumberMinimum price for instrument
payload.data.{exchange}.{instrument}.limit_amount_minnumberMinimum amount for instrument
payload.data.{exchange}.{instrument}.precision_pricenumberPrecision price for instrument
payload.data.{exchange}.{instrument}.precision_amountnumberPrecision amount for instrument
payload.data.{exchange}.{instrument}.expirationtimestampThe time when the instrument will expire.
payload.data.{exchange}.{instrument}.underlyingstringUnderlying for instrument
payload.data.{exchange}.{instrument}.nativeInstrumentstringThe name of instrument
payload.data.{exchange}.{instrument}.quoteAssetstringQuote asset for instrument
payload.data.{exchange}.{instrument}.contractSizenumberContract size for instrument (also known as the contract multiplier)
payload.data.{exchange}.{instrument}.marginTypestringMargin Type for instrument
payload.data.{exchange}.{instrument}.optionTypestringEither 'call' or 'put'
payload.data.{exchange}.{instrument}.strikePricenumberThe strike price of options instrument
payload.data.{exchange}.{instrument}.originalReferenceobjectThe full payload from the exchanges directly for instrument
Language
Credentials
Header
Click Try It! to start a request and see the response here!