获取某个币种在所选交易所的合约成交额、现货成交额，以及两者的比值（合约 ÷ 现货），按时间周期返回。适合观察交易是集中在合约市场还是现货市场。
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
以下 API 等级可以调用本接口：初创 标准 专业 企业
响应数据
data 为数组，每个元素是一个周期，time 为周期的开始时间（毫秒），按时间从早到晚排列。futures_vol_usd、spot_vol_usd 是所选交易所中该币种在这个周期内的合约、现货成交额（美元），futures_spot_vol_ratio 是两者之比。
比值是倍数，不是百分数
futures_spot_vol_ratio等于futures_vol_usd ÷ spot_vol_usd。16.5868表示合约成交额约是现货成交额的 16.59 倍，1表示两者相等。
200 · application/json · 响应示例见右侧面板。
| 字段 | 类型 | 必返 | 说明 |
|---|---|---|---|
code | string | 是 | 业务状态码，"0" 表示成功 |
msg | string | 否 | 结果说明；成功时可能不返回 |
data | array of object | 是 | 周期数组，按时间从早到晚排列 |
data[].time | integer（int64） | 是 | 周期开始时间，毫秒时间戳（UTC） |
data[].futures_spot_vol_ratio | number | 是 | 合约成交额 ÷ 现货成交额，单位为倍；1 表示两者相等 |
data[].futures_vol_usd | number | 是 | 该周期的合约成交额（合约成交量），美元 |
data[].spot_vol_usd | number | 是 | 该周期的现货成交额（现货成交量），美元 |
API 等级
只有下表中标为可以的 API 等级能调用本接口。各等级价格见 API 等级。
| API 等级 | 能否调用 |
|---|---|
| 业余 | ❌ 不可以 |
| 初创 | ✅ 可以 |
| 标准 | ✅ 可以 |
| 专业 | ✅ 可以 |
| 企业 | ✅ 可以 |
用 AI 调用本接口
选一个任务，点「在 ChatGPT 中打开」或「在 Claude 中打开」，AI 会先读取本页说明，再直接给出结果；也可以点「复制」，把完整提示词粘贴到你常用的 AI 工具里。
本接口通过 REST API 提供数据，可使用上方提示词让 AI 编写调用代码。MCP 可调用的工具见 CoinGlass MCP。
应用场景
| 场景 | 说明 |
|---|---|
| 判断行情由谁推动 | 比值走高说明交易集中在合约市场，行情更多由杠杆资金推动；比值走低说明现货交易占比在提升。 |
| 观察投机热度 | 比值在短时间内快速放大，通常意味着合约交易明显升温，可与聚合持仓历史（K 线）一起观察。 |
| 比较交易所结构 | 分别查询不同交易所，比较各平台合约与现货交易的相对活跃程度。 |
| 构建量化因子 | 把比值的水平和变化作为择时或风控研究中的市场结构因子。 |
相关接口
| 接口 | 区别 |
|---|---|
| 交易所成交量历史 | 各交易所合约成交量的历史曲线 |
| 币种主动买卖历史 | 合约市场主动买入与主动卖出的成交额 |
| 现货币种主动买卖历史 | 现货市场主动买入与主动卖出的成交额 |
| 支持的交易所 | 查询 exchange_list 可填的交易所名称 |
常见问题
比值 16.5 是 16.5% 还是 16.5 倍？
是倍数。futures_spot_vol_ratio 等于合约成交额除以现货成交额，16.5 表示合约成交额约是现货的 16.5 倍。
exchange_list 写错了会报错吗？
不一定。写错或不支持的交易所名称可能被直接忽略，返回的只是其余交易所的数据。建议先用「支持的交易所」接口核对名称。
同时传了 start_time 和 end_time，为什么返回条数比 limit 多？
同时指定起止时间时，返回条数可能由时间范围决定，而不是 limit。例如传 interval=1h、limit=2，start_time 为 01:00、end_time 为 04:00（2026-10-20，UTC），返回了 3 条，第一条从 01:00 开始。
多久更新一次？
实时更新。最后一个周期尚未结束，成交额会随新的成交继续变化。
深入了解：合约与现货成交量比值
什么是合约与现货成交量比值？
用同一时间段内合约市场的成交额除以现货市场的成交额，衡量交易活动在合约和现货之间的分布。比值大于 1 说明合约成交更多。
比值高低通常说明什么？
比值越高，说明交易越集中在合约市场，杠杆资金对价格的影响越大；比值下降，说明现货交易的占比在提升。比值反映的是市场结构，不能单独用来判断涨跌方向。
比较不同时期的比值要注意什么？
请保持 exchange_list 的交易所范围不变，否则比值的变化可能只是统计范围不同造成的。可填的交易所名称见「支持的交易所」接口。