Provides batched historical OHLCV (Open, High, Low, Close, Volume) data for multiple perpetual futures instruments within a specified date range, including timestamps, price levels, and trading volumes across exchanges.
Important Notice: Upcoming Changes to Batch Endpoints
Please take a moment to review the change log details here!
Time Range Limit
The maximum time range (difference between startDate and endDate) is:
- 62 days of daily, hourly or minutely data
In order to get more than the maximum allowed, you can use the Historical endpoint found here .
Not specifying startDate and endDate
If the startDate and endDate query parameters are not provided, the API will return the previous 62 days 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 | 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. |