Funding Rate History - One Trading API

Retrieve the historical funding rates for a specific instrument. This endpoint provides the settled funding rates, updated every 4 hours.

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

Funding rates are only available for futures markets.

[ { "instrument_code": "BTC_EUR_P", "funding_rate": "0.00002221799", "mark_price": "92525.35", "time": 1733397387858 }, { "instrument_code": "BTC_EUR_P", "funding_rate": "0.00002311127", "mark_price": "92812.40", "time": 1733411787858 }, { "instrument_code": "BTC_EUR_P", "funding_rate": "0.00002329418", "mark_price": "92955.98", "time": 1733411787858 } ]

Request

Authorization

Add the parameter

Authorization

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

Example:

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

Query Params

instrument_code

string

required

The specific instrument code (e.g. BTC_EUR_P) to fetch the funding rate for.

Example:

BTC_EUR_P

from

integer

optional

Timestamp in ms to get funding rate from (INCLUSIVE)

Example:

1733397387858

integer

optional

Timestamp in ms to get funding rate until (INCLUSIVE)

Example:

1733411787858

limit

integer

optional

Number of funding rate history records to return

>= 1<= 1000

Default:

100

Example:

1000

Responses

🟢200Success

application/json

Body

array of:

instrument_code

string

required

The unique identifier for the instrument

funding_rate

string

required

The funding rate applied at the time of settlement in fractional form. Negative rates indicate shorts paying longs, and positive rates indicate longs paying shorts.

mark_price

string

required

The mark price of the instrument at the time the funding rate was settled.

time

integer

required

Unix timestamp (in milliseconds) indicating the exact time the funding rate was settled.