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.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
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 DelayedFor 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.
| Field | Type | Always Returned | Description |
|---|---|---|---|
code | string | Yes | Business status code; "0" means success |
msg | string | No | Result message |
data | array of object | Yes | Array of candles; each element is one candle |
data[].time | integer (int64) | Yes | Interval start time, timestamp in milliseconds (UTC) |
data[].open | string | Yes | Funding rate at the start of the interval; in %, 0.01 means 0.01% |
data[].high | string or number | Yes | Highest funding rate within the interval, in %; may be a string or a number; convert to a number before calculating |
data[].low | string or number | Yes | Lowest funding rate within the interval, in %; may be a string or a number; convert to a number before calculating |
data[].close | string | Yes | Predicted 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 Plan | Access | Available Candle Intervals (interval Parameter) |
|---|---|---|
| Hobbyist | ✅ Yes | 4 hours and above: 4h, 6h, 8h, 12h, 1d, 1w |
| Startup | ✅ Yes | 30 minutes and above: 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 1w |
| Standard | ✅ Yes | All intervals, minimum 1 minute (1m) |
| Professional | ✅ Yes | All intervals, minimum 1 minute (1m) |
| Enterprise | ✅ Yes | All 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.
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
| Scenario | Description |
|---|---|
| Gauge Long/Short Sentiment | A 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 Action | Align it with Pair Price OHLC History by time to see how price behaved before and after extreme funding rates. |
| Compare Exchanges | The same coin may have different funding rates on different exchanges, which you can use to spot funding rate gaps across platforms. |
| Strategy Backtesting | Use the funding rate as a sentiment factor to backtest entry/exit or hedging rules on a single trading pair. |
Related Endpoints
| Endpoint | How It Differs |
|---|---|
| OI-Weighted Funding Rate OHLC History | Coin funding rate weighted by open interest across multiple exchanges |
| Volume-Weighted Funding Rate OHLC History | Coin funding rate weighted by volume across multiple exchanges |
| Coin Funding Rate by Exchange | Current funding rate and settlement interval on each exchange |
| Open Interest OHLC History | Open interest candles for the same trading pair |
| Supported Exchanges and Pairs | Look 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.
