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