Funding Rate OHLC History

Get the funding rate history for a futures trading pair on an exchange, returned as candles (open, high, low, close), in %. Useful for reviewing how long/short sentiment changed in a single market, or for funding rate backtesting.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Available on all API plans: Hobbyist Startup Standard Professional Enterprise

The candle intervals you can query differ by API plan; see API Plans and Available Intervals below on this page.

Response Data

Funding rates are returned as percentage values: 0.01 means 0.01%, so you do not need to multiply by 100 when displaying them. time is the start time of the interval (milliseconds). interval is only the candle interval; it does not represent the funding rate settlement interval. close is the predicted funding rate at the end of the interval and is not the same as the final settled rate; this endpoint does not provide the historical settlement interval that applied to each record. open and close are returned as strings; high and low may be strings or numbers. Convert the values to numbers before calculating. In queries on 2026-10-26 (UTC), low in the latest candle (including one that had just closed) could be numeric, but this did not occur on every request.

📘

Funding Fee Settlement May Be Delayed

For example, a position opened at 08:00:05 (UTC) may still be included in the current funding fee settlement.

200 · application/json · See the response example in the right panel.

FieldTypeAlways ReturnedDescription
codestringYesBusiness status code; "0" means success
msgstringNoResult message
dataarray of objectYesArray of candles; each element is one candle
data[].timeinteger (int64)YesInterval start time, timestamp in milliseconds (UTC)
data[].openstringYesFunding rate at the start of the interval; in %, 0.01 means 0.01%
data[].highstring or numberYesHighest funding rate within the interval, in %; may be a string or a number; convert to a number before calculating
data[].lowstring or numberYesLowest funding rate within the interval, in %; may be a string or a number; convert to a number before calculating
data[].closestringYesPredicted funding rate at the end of the interval (not the same as the final settled rate), in %; for an interval that has not yet closed, this is the latest value

API Plans and Available Intervals

All API plans can call this endpoint; they differ in the candle intervals they can query: the lower the plan, the longer the shortest available interval. For the price of each plan, see API Plans.

API PlanAccessAvailable Candle Intervals (interval Parameter)
Hobbyist✅ Yes4 hours and above: 4h, 6h, 8h, 12h, 1d, 1w
Startup✅ Yes30 minutes and above: 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 1w
Standard✅ YesAll intervals, minimum 1 minute (1m)
Professional✅ YesAll intervals, minimum 1 minute (1m)
Enterprise✅ YesAll intervals, minimum 1 minute (1m)

For how much historical data each interval can query, see Intervals.

Use This Endpoint with AI

Pick a task and click Open in ChatGPT or Open in Claude: the AI reads this page first and then gives you the result. You can also click Copy and paste the full prompt into the AI tool you use.

Fetch data with Python
Have AI write a Python function that fetches the daily funding rate candles for BTCUSDT on Binance over the last 30 days.
Compare multiple exchanges
Have AI write code that compares the BTC funding rate trends on Binance, OKX and Bybit.
Understand this endpoint
Have AI explain the parameters, the response fields and what the funding rate means in plain language.

Want AI to query real-time data without writing code? Connect CoinGlass MCP in Claude or Cursor and ask in plain language, for example: “What has the funding rate of the BTCUSDT perpetual contract on Binance been over the last 7 days?”

Use Cases

ScenarioDescription
Gauge Long/Short SentimentA funding rate that stays positive and keeps rising shows that longs are willing to pay to hold their positions and sentiment is running hot; a turn to negative shows that shorts have the upper hand.
Compare with Price ActionAlign it with Pair Price OHLC History by time to see how price behaved before and after extreme funding rates.
Compare ExchangesThe same coin may have different funding rates on different exchanges, which you can use to spot funding rate gaps across platforms.
Strategy BacktestingUse the funding rate as a sentiment factor to backtest entry/exit or hedging rules on a single trading pair.

Related Endpoints

EndpointHow It Differs
OI-Weighted Funding Rate OHLC HistoryCoin funding rate weighted by open interest across multiple exchanges
Volume-Weighted Funding Rate OHLC HistoryCoin funding rate weighted by volume across multiple exchanges
Coin Funding Rate by ExchangeCurrent funding rate and settlement interval on each exchange
Open Interest OHLC HistoryOpen interest candles for the same trading pair
Supported Exchanges and PairsLook up the valid values for exchange and symbol

FAQ

Is a funding rate of 0.01 equal to 0.01% or 1%?

It is 0.01%. The funding rates from this endpoint are already percentage values, so you do not need to multiply them by 100 when displaying them.

Does interval=8h mean the data is returned by settlement interval?

No. interval is only the candle interval; it does not represent the funding rate settlement interval. close is the predicted funding rate at the end of the interval and is not the same as the final settled rate. This endpoint does not provide the historical settlement interval that applied to each record.

What should I pass for symbol?

Pass a trading pair here, not a coin; for example, the BTC perpetual contract on Binance is BTCUSDT. Exchanges write pairs differently, so go by what the Supported Exchanges and Pairs endpoint returns.

Why do the values of the last candle keep changing?

The last candle corresponds to an interval that has not yet closed; close is the latest predicted funding rate.

Learn More: Bitcoin Funding Rate

What Is the Funding Rate?

The funding rate is a periodic fee that perpetual contracts use to keep the contract price close to the spot price. It is paid between longs and shorts; the exchange itself does not collect it.

What Do Positive and Negative Funding Rates Indicate?

When it is positive, longs pay shorts, which usually means demand for long positions is stronger and sentiment is running hot; when it is negative, shorts pay longs, which means the short side is more crowded. The more extreme the rate, the greater the risk of a move in the opposite direction tends to be.

How Do I View the Overall Funding Rate of Multiple Exchanges?

Use OI-Weighted Funding Rate OHLC History or Volume-Weighted Funding Rate OHLC History and pass a coin.

Query Params
string
required
Defaults to Binance

Exchange name, e.g., Binance, OKX. For the exchanges you can query, see the Supported Exchanges and Pairs endpoint.

string
required
Defaults to BTCUSDT

Trading pair symbol, e.g., BTCUSDT. Exchanges write trading pairs differently; for the pairs you can query, see the Supported Exchanges and Pairs endpoint.

string
required
Defaults to 1d

Candle interval. Options: 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 1w. The shortest interval you can use depends on your API plan: 4h for Hobbyist, 30m for Startup, and 1m for Standard and above.

int32
≤ 1000
Defaults to 1000

Number of candles to return; default 1000, accepts 1–1000. When you pass both start_time and end_time, the number of records returned is determined by the time range and does not necessarily equal limit.

int64

Start time, timestamp in milliseconds (UTC), e.g., 1790812800000 (2026-10-01 00:00 UTC). The time of the returned candles satisfies start_time ≤ time < end_time: the start time is included and the end time is excluded.

int64

End time, timestamp in milliseconds (UTC), e.g., 1792022400000 (2026-10-15 00:00 UTC). The time of the returned candles satisfies start_time ≤ time < end_time: the start time is included and the end time is excluded. For example, with interval=1d, the two example times above return 14 candles, from October 1 to October 14.

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json