获取某个币种在指定交易所的合约主动买入与主动卖出成交额合计，按周期返回，单位为美元。可用 exchange_list 自选参与汇总的交易所，适合观察全市场的买卖力量。
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
以下 API 等级均可调用本接口：业余 初创 标准 专业 企业
不同等级可查询的数据周期不同，详见本页下方的「API 等级与可用周期」。
响应数据
data 为数组，每个元素是一个周期，time 为周期的开始时间。成交额是所选交易所中该币种多个合约交易对的合计（Binance 的 BTC 合计大于单个 BTCUSDT 交易对），单位为美元，以数字返回。也可能以字符串返回，读取时建议同时兼容数字和字符串。
关于unit参数本接口目前不读取
unit参数，传入不会改变结果，只返回美元成交额，传coin也不会得到币的数量。需要币的数量时，可改用「聚合累计成交量差值（CVD）」接口并传unit=coin。
200 · application/json · 响应示例见右侧面板。
| 字段 | 类型 | 必返 | 说明 |
|---|---|---|---|
code | string | 是 | 业务状态码，"0" 表示成功 |
msg | string | 否 | 结果说明 |
data | array of object | 是 | 周期数组，每个元素是一个周期 |
data[].time | integer（int64） | 是 | 周期开始时间，毫秒时间戳（UTC） |
data[].aggregated_buy_volume_usd | number | 是 | 所选交易所合计的主动买入成交额，美元 |
data[].aggregated_sell_volume_usd | number | 是 | 所选交易所合计的主动卖出成交额，美元 |
API 等级与可用周期
所有 API 等级都可以调用本接口，区别在于能查询的数据周期：等级越低，能用的最短周期越长。各等级价格见 API 等级。
| API 等级 | 能否调用 | 可用的数据周期（interval 参数） |
|---|---|---|
| 业余 | ✅ 可以 | 4 小时及以上：4h、6h、8h、12h、1d、1w |
| 初创 | ✅ 可以 | 30 分钟及以上：30m、1h、2h、4h、6h、8h、12h、1d、1w |
| 标准 | ✅ 可以 | 全部周期，最短 1 分钟（1m） |
| 专业 | ✅ 可以 | 全部周期，最短 1 分钟（1m） |
| 企业 | ✅ 可以 | 全部周期，最短 1 分钟（1m） |
各周期能查询多长的历史数据，见时间周期与 interval。
用 AI 调用本接口
选一个任务，点「在 ChatGPT 中打开」或「在 Claude 中打开」，AI 会先读取本页说明，再直接给出结果；也可以点「复制」，把完整提示词粘贴到你常用的 AI 工具里。
本接口通过 REST API 提供数据，可使用上方提示词让 AI 编写调用代码。MCP 可调用的工具见 CoinGlass MCP。
应用场景
| 场景 | 说明 |
|---|---|
| 观察全市场买卖力量 | 汇总多个交易所后，主动买卖额更能代表整个合约市场的买卖倾向，减少单一平台的噪音。 |
| 自选交易所范围 | 只统计你关心的交易所，例如只看 Binance、OKX、Bybit 三大平台的合计。 |
| 确认趋势 | 价格突破时观察主动买入额是否同步放大，判断突破是否有真实买盘支持。 |
| 生成市场报告 | 在日报、周报中展示主要币种的主动买卖差，快速说明市场情绪。 |
相关接口
| 接口 | 区别 |
|---|---|
| 交易对主动买卖历史 | 单个交易所、单个交易对的主动买卖额 |
| 聚合累计成交量差值（CVD） | 汇总方式相同，并附带累计差值 |
| 单币种流入流出 | 多个时间窗口的主动买卖额和净流入 |
| 现货币种主动买卖历史 | 现货市场的同类数据 |
| 支持的交易所 | 查询 exchange_list 可填的交易所名称 |
常见问题
传了 unit=coin，为什么返回的还是美元？
本接口目前不读取 unit 参数，传入不会改变结果，只返回美元成交额。需要币的数量时，可改用「聚合累计成交量差值（CVD）」接口并传 unit=coin，它同样按周期返回所选交易所合计的主动买入、主动卖出。
exchange_list 写错了会报错吗？
不一定。写错或不支持的交易所名称可能被直接忽略，返回的只是其余交易所的合计。建议先用「支持的交易所」接口核对名称。
同时传了 start_time 和 end_time，为什么返回条数和 limit 不一样？
同时传开始和结束时间时，返回哪些周期由时间范围决定，条数不一定等于 limit。例如 interval=1h、limit=2，时间范围为 3 小时，返回了 3 条。只想要固定条数时，可以不传时间（以当前时间为终点向前取），或只传 start_time 和 limit。
为什么最后一个周期的数值一直在变？
以当前时间为终点查询时（例如不传 end_time），最后一条通常是尚未结束的周期，成交额会随新成交继续累加。做统计或回测时，建议只用已结束的周期。
深入了解：全市场主动买卖成交额
为什么要看多个交易所的合计？
单个交易所的主动买卖可能受个别大户或平台活动影响，合计后更能反映整个市场的买卖倾向。
主动买卖差和价格背离说明什么？
价格上涨而主动卖出额持续大于买入额，说明上涨中有人在持续抛售，走势可能转弱；价格下跌而主动买入占优，可能有资金在逢低承接。
如何查看累计的买卖差？
使用「聚合累计成交量差值（CVD）」接口，它在每个周期的主动买卖额之外，还给出逐周期累加的差值。