Get the cumulative funding rate of each coin on each exchange over a period (1, 7, 30 or 365 days), listed separately for stablecoin-margined and coin-margined futures, in %. Useful for estimating holding costs and comparing long-term funding rate levels across platforms.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Available on all API plans: Hobbyist Startup Standard Professional Enterprise
Response Data
data is an array; each element is one coin. stablecoin_margin_list holds the cumulative funding rates of USDT/USD-margined (stablecoin-margined) futures, and token_margin_list holds those of coin-margined futures; each list is broken down by exchange. funding_rate is the cumulative funding rate over the selected range, in %: 0.03 means 0.03%. Not every exchange has data: some entries contain only exchange and no funding_rate; check whether the field exists before reading it, and do not treat it as 0.
Exchange names are uppercaseThe
exchangevalues this endpoint actually returns are uppercase, e.g.,BINANCE,OKX, unlike theBinancespelling in endpoints such as “Coin Funding Rate by Exchange”. When matching by name, normalize the case first.
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 | List of coins; each element is one coin |
data[].symbol | string | Yes | Coin, e.g., BTC |
data[].stablecoin_margin_list | array of object | Yes | Cumulative funding rates on each exchange in USDT/USD-margined (stablecoin-margined) mode |
data[].stablecoin_margin_list[].exchange | string | Yes | Exchange name, in uppercase, e.g., BINANCE |
data[].stablecoin_margin_list[].funding_rate | number | No | Cumulative funding rate over the selected time range, in %; some entries contain only exchange and do not return this field, which must not be treated as 0 |
data[].token_margin_list | array of object | Yes | Cumulative funding rates on each exchange in coin-margined mode |
data[].token_margin_list[].exchange | string | Yes | Exchange name, in uppercase |
data[].token_margin_list[].funding_rate | number | No | Cumulative funding rate over the selected time range, in %; some entries contain only exchange and do not return this field, which must not be treated as 0 |
API Plans
All API plans can call this endpoint. For the price of each plan, see API Plans.
| API Plan | Access |
|---|---|
| Hobbyist | ✅ Yes |
| Startup | ✅ Yes |
| Standard | ✅ Yes |
| Professional | ✅ Yes |
| Enterprise | ✅ Yes |
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.
This endpoint provides data through the REST API. Use the prompts above to have AI write the request code. For the tools available through MCP, see CoinGlass MCP.
Use Cases
| Scenario | Description |
|---|---|
| Estimate Holding Costs | Position amount × cumulative rate ÷ 100 gives the funding fees longs need to pay (or shorts receive) over that period. |
| Compare Rate Levels Across Platforms | The long-term cumulative rates of the same coin differ across exchanges, which can help you choose a platform with lower holding costs. |
| Evaluate Funding Rate Income | Provides a reference for strategies that collect funding rates over the long term; can be used together with Funding Rate Arbitrage. |
| Market Sentiment Review | Use the 7-day and 30-day cumulative rates to review whether long/short sentiment stayed persistently overheated over a period. |
Related Endpoints
| Endpoint | How It Differs |
|---|---|
| Coin Funding Rate by Exchange | Current funding rates and settlement intervals on each exchange |
| Funding Rate OHLC History | Historical trend of a single trading pair's funding rate |
| Funding Rate Arbitrage | Cross-exchange arbitrage combinations selected by funding rate difference |
FAQ
What does a cumulative funding rate of 0.03 mean?
It means the funding rate added up to 0.03% over the selected time range. The value is already a percentage value, so there is no need to multiply by 100. When it is positive, longs paid shorts in total; when it is negative, the opposite.
What values can range take?
1d, 7d, 30d, 365d. range is required and has no default value.
Why are the exchange names uppercase?
The exchange values this endpoint actually returns are uppercase (e.g., BINANCE), unlike the spelling in other endpoints. When matching by name, normalize the case first.
How often is it updated?
Every hour.
Learn More: Cumulative Funding Rate
What Is the Cumulative Funding Rate?
Adding up the funding rates of every settlement over a period gives the cumulative funding rate. It represents the funding fees paid or received for holding a position over that period, as a proportion of the position value.
How Do I Convert the Cumulative Funding Rate into a Holding Cost?
Position value × cumulative funding rate ÷ 100. For example, with a $100,000 position and a cumulative rate of 0.03 (i.e., 0.03%), the funding fees for that period are about $30.
How Do I View the Funding Rate of a Single Settlement?
Use Coin Funding Rate by Exchange to view current rates, or Funding Rate OHLC History to view historical trends.
