Get a coin's futures taker buy and taker sell trading volume (USD) and ratios across multiple exchanges, including the total across all exchanges and a per-exchange breakdown. Useful for judging whether buyers or sellers were more aggressive over a period.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Available on all API plans: Hobbyist Startup Standard Professional Enterprise
Response Data
data is an object: the outer fields are the total across all exchanges, and exchange_list is the per-exchange breakdown. The statistics cover taker trades within the range time range, and amounts are in USD.
Ratio Fields Are Already Percentage Values
buy_ratioandsell_ratioare in %:50.13means 50.13%, so there is no need to multiply by 100. When total volume is greater than 0, the two add up to about 100. When total volume is 0, both ratios are 0.
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 |
success | boolean | No | Whether the request succeeded |
data | object | Yes | Taker buy/sell statistics |
data.symbol | string | Yes | Coin |
data.buy_ratio | number | Yes | Taker buy ratio, total across all exchanges, in % |
data.sell_ratio | number | Yes | Taker sell ratio, total across all exchanges, in % |
data.buy_vol_usd | number | Yes | Taker buy amount, total across all exchanges, in USD |
data.sell_vol_usd | number | Yes | Taker sell amount, total across all exchanges, in USD |
data.exchange_list | array of object | Yes | Buy/sell data for each exchange |
data.exchange_list[].exchange | string | Yes | Exchange name |
data.exchange_list[].buy_ratio | number | Yes | Taker buy ratio on this exchange, in % |
data.exchange_list[].sell_ratio | number | Yes | Taker sell ratio on this exchange, in % |
data.exchange_list[].buy_vol_usd | number | Yes | Taker buy amount on this exchange, in USD |
data.exchange_list[].sell_vol_usd | number | Yes | Taker sell amount on this exchange, in USD |
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 |
|---|---|
| Gauge Short-Term Buying and Selling Pressure | A taker buy ratio above 50% means buyers were more willing to take resting orders directly during that period, and short-term sentiment leans bullish. |
| Compare Exchanges | See on which exchange taker buying or taker selling is most concentrated, to judge on which platform capital is more active. |
| Market Dashboard | Use it as a data source for a real-time dashboard comparing buying and selling pressure across multiple time ranges. |
| Combine with Long/Short Ratio Analysis | View it alongside Global Long/Short Account Ratio History to tell whether sentiment stays in positions or has already shown up in trades. |
Related Endpoints
| Endpoint | How It Differs |
|---|---|
| Coin Taker Buy/Sell History | Historical trend of a coin's taker buy/sell trading volume (USD) |
| Pair Taker Buy/Sell History | Taker buy/sell history for a single trading pair |
| Global Long/Short Account Ratio History | Long/short sentiment at the account level |
| Supported Coins | Look up the coins you can pass in symbol |
FAQ
Is a buy_ratio of 50.13 50.13% or 5013%?
It is 50.13%. buy_ratio and sell_ratio are already percentage values, and add up to about 100 when total volume is greater than 0. When total volume is 0, both ratios are 0.
Should symbol be BTC or BTCUSDT?
Pass a coin, such as BTC or ETH, not a trading pair. For the coins you can query, see the Supported Coins endpoint.
How does range relate to historical data?
range only determines how far back the trades are counted; this endpoint returns only the total for that period, not a historical series. For historical trends, use Coin Taker Buy/Sell History.
How often is it updated?
Every second.
Learn More: Futures Taker Buy/Sell Ratio
What Are Taker Buys and Taker Sells?
A taker buy is a trade in which the buyer trades directly at the price of a seller's resting order (taking the sell order); a taker sell is the opposite. Taker trades represent the side willing to trade immediately and reflect urgent buying or selling intent better than resting orders do.
Does a High Taker Buy/Sell Ratio Mean the Price Will Rise?
A high taker buy ratio means buyers are more aggressive in the short term, but trades alone do not determine the direction. If there is a lot of taker buying but the price fails to rise, it may mean there is heavy selling pressure from resting orders above.
How Do I View Historical Changes in Taker Buy/Sell?
This endpoint returns only the total for one period. For historical trends, use Coin Taker Buy/Sell History or Pair Taker Buy/Sell History.