Funding Rate History

Retrieve the historical settled funding rates for one or more futures instruments. This endpoint provides the settled funding rates, updated at the end of each funding period (every 4 hours for crypto perpetuals).

An instrument code is the id property from the Instruments endpoint.

from/to accept epoch (s, ms, µs or ns) or an ISO 8601 UTC timestamp ending in Z (or YYYY-MM-DD). from must be on or after 2024-01-01, not in the future, and strictly before to; to is exclusive. If neither is given, the window is the last 7 days (starting at 00:00 UTC). If only from is given, to is from + 7 days (capped at now); if only to is given, from is 7 days earlier (at 00:00 UTC). The range is applied to each record's timestamp.

cursor is an opaque string. Pass the value from the previous response unchanged; it is null on the last page.

Unknown query parameters are rejected with 400 UNEXPECTED_PARAMETERS.

Funding rates are only available for futures markets.

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

curl --location 'https://api.onetrading.com/fast/v1/funding-rate/history?instrument_code=BTC_USD_P&from=1733397387858&to=1733411787858&limit=100&cursor=undefined&order=DESC' \ --header 'Authorization: Bearer <token>'

{ "funding_rates": [ { "instrument_code": "BTC_USD_P", "funding_rate": "0.000017909161806883844", "mark_price": "87829.7", "time": "1766491200000", "timestamp": "2025-12-23T12:00:00Z" }, { "instrument_code": "BTC_USD_P", "funding_rate": "0.00002311127", "mark_price": "87612.4", "time": "1766476800000", "timestamp": "2025-12-23T08:00:00Z" } ], "from": "2025-12-17T00:00:00.000000000Z", "to": "2025-12-24T09:30:00.000000000Z", "cursor": "eyJlcG9jaCI6MTc2NjQ3NjgwMDAwMDAwMX0=" }

Request

Responses