Exchange Balance Chart

Get the historical series of on-chain balances on each exchange for a coin, together with the coin price on the same time axis, ready for plotting an “exchange balances + price” chart directly.

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

Response Data

data is an object made up of three parts: time_list is the time axis, price_list holds the prices at the same points in time, and data_map gives balance series by exchange. The three correspond one-to-one by position: time_list[i], price_list[i] and data_map.<exchange>[i] are data for the same moment. This endpoint has no time parameters and returns the full history at once; as of 2026-10-20, symbol=BTC returns 676 time points, the first being 2024-10-31 00:00 UTC.

📘

How exchange names are written

The keys of data_map are exchange names with inconsistent capitalization, e.g., Binance, bitFlyer, Coinbase Pro, Gate.io. Normalize the case before matching by name. Time points with no data return null; skip them in calculations rather than treating them as 0.

🚧

Gate and Gate.io are the same data

The endpoint copies the Gate balance series under the Gate.io key, so the two have exactly the same values. When summing balances across exchanges, take only one of them; otherwise Gate is counted twice.

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

FieldTypeAlways ReturnedDescription
codestringYesBusiness status code; "0" means success
msgstringNoResult message; not returned on success
dataobjectYesChart data, including the time axis, prices and each exchange's balance series
data.time_listarray of integerYesTime axis, timestamps in milliseconds (UTC)
data.price_listarray of numberYesCoin prices corresponding to the time axis
data.data_mapobjectYesBalance series of each exchange, keyed by exchange name
data.data_map.<exchange>array of numberNoBalance series of this exchange, the same length as time_list, in number of coins; null at time points with no data

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.

Plot with Python
Have AI write code that plots the BTC balance trends of several exchanges with the price overlaid.
Calculate total exchange balance
Have AI write a function that adds up the balances of all exchanges at each time point.
Understand this endpoint
Have AI explain the response structure 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
Exchange Balance ChartsPlot the historical balance curve of each exchange directly and observe how the distribution of coins across exchanges changes.
Price vs. BalancePrice and balances share the same time axis, making it easy to see whether coins are flowing into or out of exchanges when the price rises or falls.
Long-Term Trend ResearchTrack long-term changes in exchange balances to judge whether holders are withdrawing coins to hold them or moving coins onto exchanges.
Charts for Research ReportsA single request returns all the data needed for plotting, which suits reports and dashboards.

Related Endpoints

EndpointHow It Differs
Exchange Balance ListCurrent balance on each exchange and changes over 1 to 30 days
Exchange Asset TransparencyAsset details of a given exchange's wallet addresses
Whale TransfersLarge on-chain transfers of $10 million or more
Exchange Open Interest History ChartSame structure, but returns futures open interest for each exchange

FAQ

How do the three arrays correspond?

By position: time_list[i] is the time, price_list[i] is the price at that time, and the i-th value of each exchange's array in data_map is that exchange's balance at that time.

Why are some values null?

It means the exchange has no balance data at that time point. Skip null when calculating totals or plotting; do not treat it as 0.

Why do Gate and Gate.io have the same values?

The Gate.io key returns the same data as Gate. Take only one of them when summing to avoid double counting.

Can I query only a specific period?

No. This endpoint has no time parameters and returns the full history at once; slice out the period you need locally by time_list.

Learn More: Exchange Balance History

What Does a Long-Term Decline in Exchange Balances Indicate?

It usually indicates that more and more coins are being withdrawn to personal wallets or cold storage, leaving fewer coins on exchanges that can be sold at any time, which is often seen as a sign of a strong willingness to hold; however, it may also be that an exchange changed its wallet addresses, so judge it together with other data.

Why Overlay the Price?

Putting price and balances together shows whether, as the market rises or falls, coins are flowing into exchanges (possibly to be sold) or out of exchanges (possibly to be held long term).

What If I Only Want Current Balances and Recent Changes?

Use Exchange Balance List, which directly returns each exchange's current balance and its changes over 1, 7 and 30 days.

Query Params
string
required
Defaults to BTC

Coin symbol; required, e.g., BTC, ETH, USDT(ETH). Supported coins: BTC, ETH, 1INCH, AAVE, AMP, BAL, BLZ, BNT, BUSD, CRV, DAI, DODO, ENS, FET, FTT, GRT, GTC, GUSD, HOT, HUSD, JASMY, KNC, LINK, MASK, MATIC, OCEAN, OMG, POLY, QNT, SAI, SKL, SRM, STORJ, SUSD, SUSHI, TUSD, UNI, USDC, USDK, USDP, USDT(ETH), VGX, XRP, YFI, ZRX. Pass USDT(ETH) exactly as written, including the parentheses.

Responses

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