Batch Historical (SWAPS only)

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 and endDate 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/PathValue TypeDescription
payload.metadata.nextstringThe URL for the next page of data (nullable if there is no next page).
payload.metadata.api-versionstringThe version of the API used for this request.
payload.data[].instrumentstringThe instrument or trading pair for which OHLCV data is recorded (e.g., BTCUSD_PERP).
payload.data[].exchangestringThe name of the exchange where the OHLCV data applies (e.g., binance).
payload.data[].exchangeTimestampintegerThe timestamp from the exchange in milliseconds since epoch.
payload.data[].openfloatThe opening price of the instrument for the specified timestamp.
payload.data[].highfloatThe highest price of the instrument for the specified timestamp.
payload.data[].lowfloatThe lowest price of the instrument for the specified timestamp.
payload.data[].closefloatThe closing price of the instrument for the specified timestamp.
payload.data[].volumefloatThe trading volume for the instrument during the specified timestamp.
Language
Credentials
Header
Click Try It! to start a request and see the response here!