Retrieves the historical time series OHLCV data for the specified exchange and instrument(s).
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
startDate
parameter 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
startDate
andendDate
parameters 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.
Exchanges Supported
This endpoint supports Bitmex, Huobi, Okex, and FTX.US.
Time Range Limit
The maximum time range (difference between startDate and endDate) is 1 day.
Not specifying startDate and endDate
If the startDate and endDate query parameters are not provided, the API will return the data from the previous 1 day with a 1 minute frequency.
RESPONSE DATA
JSON Field/Path | Value Type | Description |
---|---|---|
payload.metadata.next | string | The URL for the next page of data (nullable if there is no next page). |
payload.metadata.api-version | string | The version of the API used for this request. |
payload.data[].instrument | string | The instrument or trading pair for which OHLCV data is recorded (e.g., BTCUSD_PERP). |
payload.data[].exchange | string | The name of the exchange where the OHLCV data applies (e.g., binance). |
payload.data[].exchangeTimestamp | integer | The timestamp from the exchange in milliseconds since epoch. |
payload.data[].open | float | The opening price of the instrument for the specified timestamp. |
payload.data[].high | float | The highest price of the instrument for the specified timestamp. |
payload.data[].low | float | The lowest price of the instrument for the specified timestamp. |
payload.data[].close | float | The closing price of the instrument for the specified timestamp. |
payload.data[].volume | float | The trading volume for the instrument during the specified timestamp. |