Provides historical OHLCV (Open, High, Low, Close, Volume) data for Spot market trading pairs, enabling analysis of price movements and trading volumes over time across supported exchanges.
Time Range Limit
The maximum time range (difference between startDate and endDate) is 2 years.
In order to get more than the maximum allowed, you can use the
startDate&endDateparameters to move the time frame window to get the next n days/hours/minutes of data.
Not specifying startDate and endDate
If the startDate and endDate query parameters are not provided, the API will return the previous 12 months of daily data.
🚨 Important Notice for BitMEX Data 🚨
BitMEX’s volume field represents the number of contracts traded, not the volume in the base asset. To obtain the correct volume, users must adjust for contract size using underlyingToPositionMultiplier from our Reference endpoint.
For details on this calculation and how to retrieve the correct values, see our Changelog Update.
RESPONSE DATA
| JSON Field/Path | Field Type | Description |
|---|---|---|
| payload.metadata.next | string | The URL for the next page of results, if there are more results to fetch. It is a paginated cursor that allows the client to retrieve subsequent data. |
| payload.metadata.api-version | string | The version of the API being used, indicated as a date string in the format YYYY-MM-DD. |
| payload.data[{index}].instrument | string | The trading pair or instrument identifier, such as "eth_usd". |
| payload.data[{index}].exchange | string | The name of the exchange where the data originates, such as "gdax". |
| payload.data[{index}].exchangeTimestamp | number | The timestamp from the exchange in milliseconds for when the OHLCV data was captured. |
| payload.data[{index}].open | number | The opening price of the trading pair for the specified time period. |
| payload.data[{index}].high | number | The highest price of the trading pair during the specified time period. |
| payload.data[{index}].low | number | The lowest price of the trading pair during the specified time period. |
| payload.data[{index}].close | number | The closing price of the trading pair for the specified time period. |
| payload.data[{index}].volume | number | The total volume of the trading pair traded during the specified time period, in the base currency. |