获取某个币种在指定交易所的现货主动买入与主动卖出成交额合计，按周期返回，单位为美元。可用 exchange_list 自选参与汇总的交易所，适合观察现货市场整体的买卖力量。
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
以下 API 等级均可调用本接口：业余 初创 标准 专业 企业
不同等级能用的最短周期不同，详见本页下方的「API 等级与可用周期」。
响应数据
data 为数组，每个元素是一个周期，time 为周期的开始时间（毫秒）。成交额为所选交易所的现货合计，单位为美元，以数字返回。
关于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 写错了会报错吗？
不一定。写错或不支持的交易所名称可能被直接忽略，返回的只是其余交易所的合计。建议先用「现货支持的交易所和交易对」接口核对名称。
聚合包含哪些交易对？
只汇总本接口已接入、且有数据的现货市场，结果不一定包含交易所的全部现货交易对。例如 exchange_list=Binance、symbol=BTC、interval=1h 时，返回的主动买卖额与 Binance BTCUSDT 交易对完全相同。需要某一个交易对的数据时，请改用对应的交易对接口。
同时传了 start_time 和 end_time，为什么返回条数和 limit 不一样？
同时传开始和结束时间时，返回哪些周期由时间范围决定，条数不一定等于 limit。例如 interval=1h、limit=2，时间范围为 3 小时，返回了 3 条。只想要固定条数时，可以不传时间（以当前时间为终点向前取），或只传 start_time 和 limit。
深入了解：现货市场主动买卖力量
为什么要看现货市场的主动买卖？
现货买入换到的是币本身，现货主动买入放大通常代表真实需求。相比合约，现货数据受杠杆资金短线进出的影响更小。
现货主动买入多、合约主动卖出多说明什么？
常见情况是现货有人持续买入，同时有人在合约市场做空或对冲现货持仓。价格仍能上涨，说明现货买盘足以吸收合约卖压；价格走弱，说明合约卖压占了上风。可以结合合约持仓量一起看：持仓同时增加，多为新开空单；持仓减少，多为多头平仓。
如何查看累计的买卖差？
使用「现货聚合累计成交量差值（CVD）」接口，它在每个周期的主动买卖额之外，还给出逐周期累加的差值。