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.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
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 writtenThe keys of
data_mapare 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 returnnull; skip them in calculations rather than treating them as 0.
GateandGate.ioare the same dataThe endpoint copies the
Gatebalance series under theGate.iokey, 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.
| Field | Type | Always Returned | Description |
|---|---|---|---|
code | string | Yes | Business status code; "0" means success |
msg | string | No | Result message; not returned on success |
data | object | Yes | Chart data, including the time axis, prices and each exchange's balance series |
data.time_list | array of integer | Yes | Time axis, timestamps in milliseconds (UTC) |
data.price_list | array of number | Yes | Coin prices corresponding to the time axis |
data.data_map | object | Yes | Balance series of each exchange, keyed by exchange name |
data.data_map.<exchange> | array of number | No | Balance 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 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 |
|---|---|
| Exchange Balance Charts | Plot the historical balance curve of each exchange directly and observe how the distribution of coins across exchanges changes. |
| Price vs. Balance | Price 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 Research | Track long-term changes in exchange balances to judge whether holders are withdrawing coins to hold them or moving coins onto exchanges. |
| Charts for Research Reports | A single request returns all the data needed for plotting, which suits reports and dashboards. |
Related Endpoints
| Endpoint | How It Differs |
|---|---|
| Exchange Balance List | Current balance on each exchange and changes over 1 to 30 days |
| Exchange Asset Transparency | Asset details of a given exchange's wallet addresses |
| Whale Transfers | Large on-chain transfers of $10 million or more |
| Exchange Open Interest History Chart | Same 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.
