Delivers historical OHLCV (Open, High, Low, Close, Volume) data in batch format for multiple Spot market trading pairs, providing comprehensive price and volume history over specified time ranges for efficient analysis across multiple assets.
⚠️ IMPORTANT UPDATE ⚠️
Important Notice: Upcoming Changes to Batch Request Parameters
Starting January 6, 2025, we will be implementing new restrictions on batch requests to optimize performance across our platform. Specifically, batch requests using the
startDateparameter will no longer be allowed to retrieve data older than 60 days. Any requests attempting to access data beyond this limit will result in an error. Please use the Historical endpoint for those needs.Additionally, if the
startDateandendDateparameters are not provided, the API will currently return the previous 12 months of daily data by default. Beginning January 6, 2025, this default behavior will change to return only the previous 60 days of data.We are providing this advance notice to help ensure a smooth transition for all our customers. Please review and update your systems accordingly to avoid any disruptions. If you have any questions or need assistance in preparing for this change, feel free to reach out to our support team.
Thank you for your understanding and cooperation.
Time Range Limit
The maximum time range (difference between startDate and endDate) is:
- 12 months of daily data
- 30 days of hourly data
- 24 hours of minutely data
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.
RESPONSE DATA
| JSON Field/Path | Field Type | Description |
|---|---|---|
| payload.metadata.columns | array | An array of strings that represents the columns returned in the OHLCV data. Typically includes "timestamp", "open", "high", "low", "close", and "volume". |
| payload.metadata.startDate | number | The timestamp in milliseconds representing the start date for the historical OHLCV data range. |
| payload.metadata.endDate | number | The timestamp in milliseconds representing the end date for the historical OHLCV data range. |
| payload.data.{instrument}[{index}][0] | number | The timestamp in milliseconds for the OHLCV data at the specified index for the given instrument. |
| payload.data.{instrument}[{index}][1] | number | The opening price of the trading pair at the specified timestamp. |
| payload.data.{instrument}[{index}][2] | number | The highest price of the trading pair during the specified time period. |
| payload.data.{instrument}[{index}][3] | number | The lowest price of the trading pair during the specified time period. |
| payload.data.{instrument}[{index}][4] | number | The closing price of the trading pair at the specified timestamp. |
| payload.data.{instrument}[{index}][5] | number | The total volume of the trading pair traded during the specified time period, in the base currency. |