获取某个币种在多个交易所的合约主动买入、主动卖出成交额及比例，含全部交易所合计和各交易所明细。适合判断一段时间内买方还是卖方更主动。
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
以下 API 等级均可调用本接口：业余 初创 标准 专业 企业
响应数据
data 为对象：外层字段是全部交易所的合计，exchange_list 是各交易所的明细。统计的是 range 时间范围内的主动成交，金额单位为美元。
比例字段已经是百分数
buy_ratio、sell_ratio的单位是 %，50.13表示 50.13%，不需要再乘以 100，总成交量大于 0 时，两者相加约为 100；总成交量为 0 时，两者均为 0。
200 · application/json · 响应示例见右侧面板。
| 字段 | 类型 | 必返 | 说明 |
|---|---|---|---|
code | string | 是 | 业务状态码，"0" 表示成功 |
msg | string | 否 | 结果说明 |
success | boolean | 否 | 请求是否成功 |
data | object | 是 | 主动买卖统计 |
data.symbol | string | 是 | 币种 |
data.buy_ratio | number | 是 | 全部交易所合计的主动买入比例，单位 % |
data.sell_ratio | number | 是 | 全部交易所合计的主动卖出比例，单位 % |
data.buy_vol_usd | number | 是 | 全部交易所合计的主动买入金额，美元 |
data.sell_vol_usd | number | 是 | 全部交易所合计的主动卖出金额，美元 |
data.exchange_list | array of object | 是 | 各个交易所的买卖数据 |
data.exchange_list[].exchange | string | 是 | 交易所名称 |
data.exchange_list[].buy_ratio | number | 是 | 该交易所的主动买入比例，单位 % |
data.exchange_list[].sell_ratio | number | 是 | 该交易所的主动卖出比例，单位 % |
data.exchange_list[].buy_vol_usd | number | 是 | 该交易所的主动买入金额，美元 |
data.exchange_list[].sell_vol_usd | number | 是 | 该交易所的主动卖出金额，美元 |
API 等级
所有 API 等级都可以调用本接口。各等级价格见 API 等级。
| API 等级 | 能否调用 |
|---|---|
| 业余 | ✅ 可以 |
| 初创 | ✅ 可以 |
| 标准 | ✅ 可以 |
| 专业 | ✅ 可以 |
| 企业 | ✅ 可以 |
用 AI 调用本接口
选一个任务，点「在 ChatGPT 中打开」或「在 Claude 中打开」，AI 会先读取本页说明，再直接给出结果；也可以点「复制」，把完整提示词粘贴到你常用的 AI 工具里。
本接口通过 REST API 提供数据，可使用上方提示词让 AI 编写调用代码。MCP 可调用的工具见 CoinGlass MCP。
应用场景
| 场景 | 说明 |
|---|---|
| 判断短线买卖力量 | 主动买入比例高于 50%，说明这段时间买方更愿意直接吃单，短线情绪偏多。 |
| 比较交易所差异 | 看哪个交易所的主动买入或卖出最集中，判断资金在哪个平台更活跃。 |
| 行情看板 | 作为实时看板的数据源，展示多个时间范围的买卖力量对比。 |
| 配合多空比分析 | 与交易对账户多空比历史一起看，区分情绪是停留在仓位上还是已经体现在成交上。 |
相关接口
| 接口 | 区别 |
|---|---|
| 币种主动买卖历史 | 币种主动买卖成交额的历史走势 |
| 交易对主动买卖历史 | 单个交易对的主动买卖历史 |
| 交易对账户多空比历史 | 账户层面的多空情绪 |
| 支持的币种 | 查询 symbol 可填的币种 |
常见问题
buy_ratio 50.13 是 50.13% 还是 5013%？
是 50.13%。buy_ratio、sell_ratio 已经是百分数，总成交量大于 0 时，两者相加约为 100；总成交量为 0 时，两者均为 0。
symbol 填 BTC 还是 BTCUSDT？
填币种，例如 BTC、ETH，不是交易对。可查询的币种见「支持的币种」接口。
range 和历史数据有什么关系？
range 只决定统计最近多长时间的成交，本接口只返回这一段时间的合计，不返回历史序列。需要历史走势，请使用「币种主动买卖历史」。
多久更新一次？
每 1 秒更新一次。
深入了解：合约主动买卖比
什么是主动买入和主动卖出？
主动买入指买方直接按卖方挂单的价格成交（吃卖单），主动卖出则相反。主动成交代表愿意立刻成交的一方，比挂单更能反映急迫的买卖意愿。
主动买卖比高说明要涨吗？
主动买入比例高说明短线买方更积极，但成交本身不决定方向。如果主动买入很多价格却涨不动，可能说明上方挂单抛压较重。