Historical

Provides detailed historical data for options tickers, including price metrics, trading volumes, Greeks, and implied volatility. This endpoint is particularly useful for analyzing past market conditions for specific options on various exchanges.

⚠️ IMPORTANT UPDATE ⚠️

⚠️

Important Update

The old endpoint https://api.amberdata.com/market/options/tickers/{instrument}/historical has been updated to https://api.amberdata.com/markets/options/tickers/{instrument} and is no longer being supported. Please update your integrations accordingly.

See changes here
  • Endpoint URL Change:
    • Old: https://api.amberdata.com/market/options/tickers/{instrument}/historical
    • New: https://api.amberdata.com/markets/options/tickers/{instrument}
  • Metadata Changes:
    • startDate and endDate fields removed from the response
    • next and api-version fields added to the response
  • Data Structure Changes:
    • The structure of the data array remains largely the same, but there are additional fields in the new schema and some fields have been renamed or removed.
  • Field Value Changes:
    • Field names are largely consistent, but note the renaming of timestamp to exchangeTimestamp and the addition of new fields such as instrument, exchangeTimestampNanoseconds, lastVolume, volumeUSD, askTimestamp, bidTimestamp, askTimestampNanoseconds, and bidTimestampNanoseconds.
    • The following fields were moved out of the stats object: low, high, volume, volume_usd, price_change
    • The following fields were moved out of the greeks object: rho, vega, delta, gamma, theta
  • Other
    • The exchange parameter is now required.
    • Include the Accept-Encoding: header in your API requests to take advantage of compressed responses.

📘

Time Range Limit

The maximum time range (difference between startDate and endDate) is 1 hour.

📘

Not specifying startDate and endDate

If the startDate and endDate query parameters are not provided, the API will return the data from the previous hour.

RESPONSE DATA(click to expand)
FieldTypeDescription
metadataobjectThe metadata associated with the data.
metadata.startDatenumber | stringThe first date/time for which data is available.
metadata.endDatenumber | stringThe last date/time for which data is available.
dataarrayThe tickers data
data.exchangestringThe name of the exchange.
data.timestampnumber or stringThe timestamp.
data.bidnumber | nullThe bid of the market pair.
data.asknumber | nullThe ask of the market pair.
data.midnumber | nullThe mid of the market pair.
data.lastnumber | nullThe last of the market pair.
data.baseVolumenumber | null
data.quoteVolumenumber | null
data.bidVolumenumber | nullIt represents the requested order size of all best bids.
data.askVolumenumber | nullIt represents the requested order size of all best asks.
data.sequencenumber | nullThe sequence number (equal to null if it is not provided by the exchange).
data.metadataobject | null
data.underlyingPricestring | nullUnderlying price for implied volatility calculations.
data.underlyingIndexstring | nullName of the underlying future, or indexPrice.
data.statsobject | null
data.stats.highnumber | nullHighest price during 24h.
data.stats.lownumber | nullLowest price during 24h.
data.stats.volumenumber | nullVolume during last 24h in base currency.
data.stats.price_changenumber | null24-hour price change expressed as a percentage, null if there weren't any trades.
data.statestring | nullThe state of the order book. Possible values are open and closed.
data.settlementPricenumber | nullThe settlement price for the instrument. Only when state = open.
data.openInterestnumber | nullThe total amount of outstanding contracts in the corresponding amount units. For perpetual and futures the amount is in USD units, for options it is amount of corresponding cryptocurrency contracts, e.g., BTC or ETH.
data.minPricenumber | nullThe minimum price for the future. Any sell orders you submit lower than this price will be clamped to this minimum.
data.maxPricenumber | nullThe maximum price for the future. Any buy orders you submit higher than this price, will be clamped to this maximum.
data.markPricenumber | nullThe mark price for the instrument.
data.markIvnumber | nullImplied volatility for mark price.
data.interestRatenumber | nullInterest rate used in implied volatility calculations.
data.indexPricenumber | nullCurrent index price.
data.greeksobject | null
data.greeks.deltanumber | nullThe delta value for the option.
data.greeks.gammanumber | nullThe gamma value for the option.
data.greeks.rhonumber | nullThe rho value for the option.
data.greeks.thetanumber | nullThe theta value for the option.
data.greeks.veganumber | nullThe vega value for the option.
data.estimatedDeliveryPricenumber | nullEstimated delivery price for the market.
data.bidIvnumber | nullImplied volatility for best bid.
data.askIvnumber | nullImplied volatility for best ask.
Language
Credentials
Header
Click Try It! to start a request and see the response here!