Batch Historical

get https://api.amberdata.com/markets/futures/batch-ohlcv/{exchange}

Provides batched historical OHLCV (Open, High, Low, Close, Volume) data for multiple futures instruments within a specified date range, including timestamps, price levels, and trading volumes across exchanges.

📘
Time Range & Data Availability Limit
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 .

🚧
Not specifying startDate and endDate
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).

🚨 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.

Path Params

exchange

string

required

Defaults to binance

The exchange for which to retrieve the most current data.

Query Params

instruments

string

required

Defaults to BTCUSDT,ETHUSDT

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

startDate

date-time

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

endDate

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

Headers

api-version

string

Accept-Encoding

string

Defaults to gzip, deflate, br

Responses

xxxxxxxxxx
curl --request GET \
     --url 'https://api.amberdata.com/markets/futures/batch-ohlcv/binance?instruments=BTCUSDT%2CETHUSDT' \
     --compressed \
     --header 'Accept-Encoding: gzip, deflate, br' \
     --header 'accept: application/json' \
     --header 'x-api-key: API_KEY'

Batch Historical

📘
Time Range & Data Availability Limit

🚧
Not specifying startDate and endDate

📘Time Range & Data Availability Limit

🚧Not specifying startDate and endDate

200200

400400

📘
Time Range & Data Availability Limit

🚧
Not specifying startDate and endDate