Cumulative Funding Rate by Exchange

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.

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

Update frequencyHourly

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 uppercase

The exchange values this endpoint actually returns are uppercase, e.g., BINANCE, OKX, unlike the Binance spelling 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.

FieldTypeAlways ReturnedDescription
codestringYesBusiness status code; "0" means success
msgstringNoResult message
dataarray of objectYesList of coins; each element is one coin
data[].symbolstringYesCoin, e.g., BTC
data[].stablecoin_margin_listarray of objectYesCumulative funding rates on each exchange in USDT/USD-margined (stablecoin-margined) mode
data[].stablecoin_margin_list[].exchangestringYesExchange name, in uppercase, e.g., BINANCE
data[].stablecoin_margin_list[].funding_ratenumberNoCumulative 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_listarray of objectYesCumulative funding rates on each exchange in coin-margined mode
data[].token_margin_list[].exchangestringYesExchange name, in uppercase
data[].token_margin_list[].funding_ratenumberNoCumulative 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 PlanAccess
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.

Estimate holding costs
Have AI write a Python function that estimates how much in funding fees a BTC long position held for 30 days would pay.
Rank cumulative rates
Have AI write code that finds the coins with the highest cumulative funding rates over the past 7 days.
Understand this endpoint
Have AI explain the cumulative funding rate and the response fields in plain language.

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

ScenarioDescription
Estimate Holding CostsPosition amount × cumulative rate ÷ 100 gives the funding fees longs need to pay (or shorts receive) over that period.
Compare Rate Levels Across PlatformsThe 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 IncomeProvides a reference for strategies that collect funding rates over the long term; can be used together with Funding Rate Arbitrage.
Market Sentiment ReviewUse the 7-day and 30-day cumulative rates to review whether long/short sentiment stayed persistently overheated over a period.

Related Endpoints

EndpointHow It Differs
Coin Funding Rate by ExchangeCurrent funding rates and settlement intervals on each exchange
Funding Rate OHLC HistoryHistorical trend of a single trading pair's funding rate
Funding Rate ArbitrageCross-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.

Query Params
string
required
Defaults to 1d

Time range of the cumulative funding rate, e.g., 1d. Options: 1d, 7d, 30d, 365d.

Responses

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