Get a coin's combined spot taker buy and taker sell trading volume on the specified exchanges, returned per interval, in USD. Use exchange_list to choose which exchanges are included in the total; useful for watching buying and selling strength across the whole spot market.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Available on all API plans: Hobbyist Startup Standard Professional Enterprise
The shortest interval you can use differs by API plan; see API Plans and Available Intervals below on this page.
Response Data
data is an array; each element is one interval, and time is the start time of the interval (milliseconds). The trading volume is the spot total across the selected exchanges, in USD, returned as a number.
About theunitParameterThis endpoint currently does not read the
unitparameter, and passing it does not change the result; it always returns trading volume in USD: passingcoinstill returns USD amounts. If you need coin quantities, convert them yourself using the price for the same period, or use Spot Aggregated Cumulative Volume Delta (CVD) instead and passunit=coin.
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 intervals; each element is one interval |
data[].time | integer (int64) | Yes | Interval start time, timestamp in milliseconds (UTC) |
data[].aggregated_buy_volume_usd | number | Yes | Spot taker buy trading volume summed across the selected exchanges, in USD |
data[].aggregated_sell_volume_usd | number | Yes | Spot taker sell trading volume summed across the selected exchanges, in USD |
API Plans and Available Intervals
All API plans can call this endpoint; they differ in the data intervals they can use: the lower the plan, the longer the shortest available interval. For the price of each plan, see API Plans.
| API Plan | Access | Available 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.
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 |
|---|---|
| Watch Spot Market-Wide Buying and Selling Strength | Once multiple exchanges are combined, taker buy/sell volume better represents the buying and selling tendency of the whole spot market and reduces the noise of any single platform. |
| Choose Your Own Exchanges | Count only the exchanges you care about, e.g., just the combined total of the three platforms Binance, OKX and Bybit. |
| Confirm Trends | When price breaks out, check whether spot taker buy volume expands at the same time to judge whether the breakout is backed by real buying. |
| Compare with Futures | Compare with the futures endpoint Coin Taker Buy/Sell History to judge whether the market move is driven by spot buying or by futures capital. |
Related Endpoints
| Endpoint | How It Differs |
|---|---|
| Spot Pair Taker Buy/Sell History | Taker buy/sell volume of a single spot trading pair on a single exchange |
| Spot Aggregated Cumulative Volume Delta (CVD) | Aggregated the same way, with the cumulative difference included; can return coin quantities |
| Spot Coin Netflow | Spot taker buy/sell volume and net inflow over multiple time windows |
| Coin Taker Buy/Sell History | The same type of data for the futures market |
| Spot Supported Exchanges and Pairs | Look up the exchange names you can pass in exchange_list |
FAQ
Why do I still get USD when I pass unit=coin?
This endpoint currently does not read the unit parameter and only returns trading volume in USD. If you need coin quantities, convert them yourself using the price for the same period, or use Spot Aggregated Cumulative Volume Delta (CVD) instead and pass unit=coin.
Does a misspelled exchange_list return an error?
Not necessarily. Misspelled or unsupported exchange names may be silently ignored, and the response is then just the total of the remaining exchanges. We recommend checking the names with the Spot Supported Exchanges and Pairs endpoint first.
Which trading pairs does the aggregation include?
Only spot markets that this endpoint has integrated and that have data are aggregated, so the result does not necessarily include all of an exchange's spot trading pairs. For example, with exchange_list=Binance, symbol=BTC and interval=1h, the returned taker buy/sell volumes are exactly the same as those of the Binance BTCUSDT pair. If you need data for one specific trading pair, use the corresponding pair endpoint instead.
Why does the number of returned data points differ from limit when I pass both start_time and end_time?
When both the start and end times are passed, which intervals are returned is determined by the time range, and the number of data points does not necessarily equal limit. For example, with interval=1h, limit=2 and a 3-hour time range, 3 data points were returned. If you only want a fixed number of data points, omit the times (data is taken backward with the current time as the end point), or pass only start_time and limit.
Learn More: Spot Market Taker Buying and Selling Strength
Why Look at Taker Buying and Selling in the Spot Market?
A spot purchase gets you the coin itself, so an increase in spot taker buying usually represents real demand. Compared with futures, spot data is less affected by leveraged capital moving in and out in the short term.
What Does More Spot Taker Buying with More Futures Taker Selling Indicate?
A common situation is that someone keeps buying on spot while at the same time someone is shorting in the futures market or hedging spot holdings. If the price can still rise, spot buying is enough to absorb the futures selling pressure; if the price weakens, the futures selling pressure has the upper hand. You can look at it together with futures open interest: if open interest rises at the same time, it is mostly new short positions being opened; if open interest falls, it is mostly longs closing their positions.
How Do I View the Cumulative Buy/Sell Difference?
Use the Spot Aggregated Cumulative Volume Delta (CVD) endpoint; in addition to each interval's taker buy and sell volume, it gives the difference accumulated interval by interval.