Historical

Retrieves the historical (time series) funding rates data for the specified futures instrument.

📘

Time Range Limit

The maximum time range (difference between startDate and endDate) is 731 days (2 years).

🚧

Not specifying startDate and endDate

If the startDate and endDate query parameters are not provided, the API will return the data from the previous 24 hours at the tick granularity.

❗️

timeInterval

Support for the timeInterval query parameter will be added soon.

RESPONSE DATA
JSON Field/PathValue TypeDescription
payload.metadata.nextstringThe URL for the next page of data (for pagination purposes).
payload.metadata.api-versionstringThe version of the API used for this request.
payload.data[].instrumentstringThe trading instrument or pair (e.g., BTCUSD_PERP).
payload.data[].exchangestringThe name of the exchange where the funding rate applies (e.g., binance).
payload.data[].exchangeTimestampintegerThe timestamp from the exchange when the funding rate was recorded.
payload.data[].exchangeTimestampNanosecondsintegerThe nanoseconds part of the timestamp, representing sub-second precision (usually 0).
payload.data[].fundingIntervalfloatThe funding interval for the instrument (nullable if not applicable).
payload.data[].fundingRatefloatThe funding rate applied during the interval (e.g., 0.00009979).
payload.data[].nextFundingRatefloatThe funding rate for the next interval (nullable if not available).
payload.data[].nextFundingTimestringThe time of the next funding event (e.g., 2024-10-03 16:00:00 000).
payload.data[].isActualFundingRatebooleanIndicates whether the funding rate is actual (true) or predicted (false).
Language
Authorization
Header
Click Try It! to start a request and see the response here!