Skip to main content
GET
/
futures
/
batch-ohlcv
/
{exchange}
Batch Historical
curl --request GET \
  --url https://api.amberdata.com/markets/futures/batch-ohlcv/{exchange} \
  --compressed \
  --header 'Accept-Encoding: <accept-encoding>' \
  --header 'x-api-key: <api-key>'
{
  "status": 200,
  "title": "OK",
  "description": "Successful request",
  "payload": {
    "metadata": {
      "next": null,
      "api-version": "2023-09-30"
    },
    "data": [
      {
        "instrument": "BTCUSDT",
        "exchangeTimestamp": 1735948800000,
        "open": 98145.7,
        "high": 98760.9,
        "low": 97438.2,
        "close": 98173.2,
        "volume": 71914.634
      },
      {
        "instrument": "ETHUSDT",
        "exchangeTimestamp": 1735948800000,
        "open": 3607.9,
        "high": 3670,
        "low": 3570.66,
        "close": 3655.99,
        "volume": 1729182.603
      }
    ]
  }
}
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 the underlyingToPositionMultiplier from our Reference endpoint.For details on this calculation and how to retrieve the correct values, see our Changelog Update.
The maximum time range (difference between startDate and endDate) is:
  • 62 days of daily, hourly or minutely data
  • This endpoint only stores the most recent 62 days of data.
  • Queries with a startDate older than 62 days from the current date will result in a 410 error.
In order to get more than the maximum allowed, you can use the Historical endpoint found here .
If you omit startDate and endDate, the API will return the most recent 62 days of daily data (not data older than 62 days from the current date).

Authorizations

​
x-api-key
string
header
required

Headers

​
Accept-Encoding
string
default:gzip, deflate, br
required
​
api-version
string

Path Parameters

​
exchange
string
default:binance
required

The exchange for which to retrieve the most current data.

Query Parameters

​
instruments
string
default:BTCUSDT,ETHUSDT
required

[Required] The instrument(s) for which to retrieve the most current data (comma separated). [Maximum] 50 instruments

​
startDate
string<date-time>

[Optional] Payload only includes data after this date (inclusive). [Formats] seconds | milliseconds | iso8601 [Examples] 1578531600 | 1578531600000 | 2020-09-01T01:00:00

​
endDate
string<date-time>

[Optional] Payload only includes data before this date (exclusive). [Formats] seconds | milliseconds | iso8601 [Examples] 1578531600 | 1578531600000 | 2020-09-01T01:00:00

​
timeInterval
string

[Optional] Time interval. [Defaults] minutes | hours | days*

​
timeFormat
string

[Optional] Time format of the timestamps in the return payload. [Defaults] milliseconds | ms* | iso | iso8601 | hr | human_readable

Response

200

​
status
integer
​
title
string
​
description
string
​
payload
object