get https://api.amberdata.com/markets/options/tickers/
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}/historicalhas been updated tohttps://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:
startDateandendDatefields removed from the responsenextandapi-versionfields added to the response- Data Structure Changes:
- The structure of the
dataarray 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
timestamptoexchangeTimestampand the addition of new fields such asinstrument,exchangeTimestampNanoseconds,lastVolume,volumeUSD,askTimestamp,bidTimestamp,askTimestampNanoseconds, andbidTimestampNanoseconds.- The following fields were moved out of the
statsobject:low,high,volume,volume_usd,price_change- The following fields were moved out of the
greeksobject:rho,vega,delta,gamma,theta- Other
- The
exchangeparameter 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
| Field | Type | Description | |
|---|---|---|---|
| metadata | object | The metadata associated with the data. | |
| metadata.startDate | `number | string` | The first date/time for which data is available. |
| metadata.endDate | `number | string` | The last date/time for which data is available. |
| data | array | The tickers data | |
| data.exchange | string | The name of the exchange. | |
| data.timestamp | number or string | The timestamp. | |
| data.bid | `number | null` | The bid of the market pair. |
| data.ask | `number | null` | The ask of the market pair. |
| data.mid | `number | null` | The mid of the market pair. |
| data.last | `number | null` | The last of the market pair. |
| data.baseVolume | `number | null` | |
| data.quoteVolume | `number | null` | |
| data.bidVolume | `number | null` | It represents the requested order size of all best bids. |
| data.askVolume | `number | null` | It represents the requested order size of all best asks. |
| data.sequence | `number | null` | The sequence number (equal to null if it is not provided by the exchange). |
| data.metadata | `object | null` | |
| data.underlyingPrice | `string | null` | Underlying price for implied volatility calculations. |
| data.underlyingIndex | `string | null` | Name of the underlying future, or indexPrice. |
| data.stats | `object | null` | |
| data.stats.high | `number | null` | Highest price during 24h. |
| data.stats.low | `number | null` | Lowest price during 24h. |
| data.stats.volume | `number | null` | Volume during last 24h in base currency. |
| data.stats.price_change | `number | null` | 24-hour price change expressed as a percentage, null if there weren't any trades. |
| data.state | `string | null` | The state of the order book. Possible values are open and closed. |
| data.settlementPrice | `number | null` | The settlement price for the instrument. Only when state = open. |
| data.openInterest | `number | null` | The 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.minPrice | `number | null` | The minimum price for the future. Any sell orders you submit lower than this price will be clamped to this minimum. |
| data.maxPrice | `number | null` | The maximum price for the future. Any buy orders you submit higher than this price, will be clamped to this maximum. |
| data.markPrice | `number | null` | The mark price for the instrument. |
| data.markIv | `number | null` | Implied volatility for mark price. |
| data.interestRate | `number | null` | Interest rate used in implied volatility calculations. |
| data.indexPrice | `number | null` | Current index price. |
| data.greeks | `object | null` | |
| data.greeks.delta | `number | null` | The delta value for the option. |
| data.greeks.gamma | `number | null` | The gamma value for the option. |
| data.greeks.rho | `number | null` | The rho value for the option. |
| data.greeks.theta | `number | null` | The theta value for the option. |
| data.greeks.vega | `number | null` | The vega value for the option. |
| data.estimatedDeliveryPrice | `number | null` | Estimated delivery price for the market. |
| data.bidIv | `number | null` | Implied volatility for best bid. |
| data.askIv | `number | null` | Implied volatility for best ask. |