get https://api.amberdata.com/markets/futures/batch-open-interest/
Provides batched historical open interest data for multiple futures instruments within a specified date range, including timestamps, open interest values, and contract types 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
startDateolder 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
startDateandendDate, the API will return the most recent 62 days of daily data (not data older than 62 days from the current date).
RESPONSE DATA (click to expand)
| 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 open interest data is recorded (e.g., BTCUSD_PERP). |
| payload.data[].exchange | string | The name of the exchange where the open interest data applies (e.g., binance). |
| payload.data[].exchangeTimestamp | integer | The timestamp from the exchange when the open interest data was recorded. |
| payload.data[].exchangeTimestampNanoseconds | integer | The nanoseconds part of the timestamp, representing sub-second precision (usually 0). |
| payload.data[].value | integer | The open interest value at the specified timestamp. |
| payload.data[].type | string | The type of the open interest contract (e.g., PERPETUAL). |