get https://api.amberdata.com/market/swaps/open-interest/exchange//historical
Provides batched historical open interest data for multiple perpetual futures instruments within a specified date range, including timestamps, open interest values, and contract types 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.
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 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). |
Responses