Batch Historical

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 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/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
Credentials
Header
Click Try It! to start a request and see the response here!