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.

📘

Time Range & Data Availability Limit

The maximum time range (difference between startDate and endDate) is:

  • 62 days of daily, hourly or minutely data
  • This endpoint only stores the most recent 62 days of data.
  • Queries with a startDate older than 62 days from the current date will result in a 410 error.

In order to get more than the maximum allowed, you can use the Historical endpoint found here .

🚧

Not specifying startDate and endDate

If you omit startDate and endDate, the API will return the most recent 62 days of daily data (not data older than 62 days from the current date).

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!