Returns batched historical funding rate data for futures instruments within a specified date range, including timestamps, actual funding rates, and projected rates across exchanges.
Important Notice: Upcoming Changes to Batch Request Parameters
Starting January 6, 2025, we will be implementing new restrictions on batch requests to optimize performance across our platform. Specifically, batch requests using the
startDateparameter will no longer be allowed to retrieve data older than 60 days. Any requests attempting to access data beyond this limit will result in an error. Please use the Historical endpoint for those needs.Additionally, if the
startDateandendDateparameters are not provided, the API will currently return the previous 12 months of daily data by default. Beginning January 6, 2025, this default behavior will change to return only the previous 60 days of data.We are providing this advance notice to help ensure a smooth transition for all our customers. Please review and update your systems accordingly to avoid any disruptions. If you have any questions or need assistance in preparing for this change, feel free to reach out to our support team.
Thank you for your understanding and cooperation.
Time Range Limit
The maximum time range (difference between startDate and endDate) is:
- 1 year of daily data (using day timeInterval)
- 31 days of hourly data (using hour timeInterval)
- 1 day of minutely data (using minute timeInterval)
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). |