get https://api.amberdata.com/market/swaps/funding-rates/exchange//historical
Returns batched historical funding rate data for perpetual futures instruments within a specified date range, including timestamps, actual funding rates, and projected rates 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 (for pagination purposes). |
| payload.metadata.api-version | string | The version of the API used for this request. |
| payload.data[].instrument | string | The trading instrument or pair (e.g., BTCUSD_PERP). |
| payload.data[].exchange | string | The name of the exchange where the funding rate applies (e.g., binance). |
| payload.data[].exchangeTimestamp | integer | The timestamp from the exchange when the funding rate was recorded. |
| payload.data[].exchangeTimestampNanoseconds | integer | The nanoseconds part of the timestamp, representing sub-second precision (usually 0). |
| payload.data[].fundingInterval | float | The funding interval for the instrument (nullable if not applicable). |
| payload.data[].fundingRate | float | The funding rate applied during the interval (e.g., 0.00009979). |
| payload.data[].nextFundingRate | float | The funding rate for the next interval (nullable if not available). |
| payload.data[].nextFundingTime | string | The time of the next funding event (e.g., 2024-10-03 16:00:00 000). |
| payload.data[].isActualFundingRate | boolean | Indicates whether the funding rate is actual (true) or predicted (false). |