获取某个交易所、某个合约交易对的全部账户多空比历史：持多单账户和持空单账户的比例，以及两者的比值。适合观察散户整体情绪偏多还是偏空。
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
以下 API 等级均可调用本接口：业余 初创 标准 专业 企业
不同等级可查询的数据周期不同，详见本页下方的「API 等级与可用周期」。
响应数据
data 为数组，每个元素是一个周期的数据，time 为周期的开始时间。数值以数字返回。这里统计的是该交易对的全部账户，按账户个数计算，不考虑每个账户的仓位大小。
占比是百分数，多空比是比值
*_long_percent、*_short_percent的单位是 %，62.62表示 62.62%，不需要再乘以 100，两者相加约为 100。*_long_short_ratio是多头占比 ÷ 空头占比，1.68表示多头是空头的 1.68 倍，不是百分数。
200 · application/json · 响应示例见右侧面板。
| 字段 | 类型 | 必返 | 说明 |
|---|---|---|---|
code | string | 是 | 业务状态码，"0" 表示成功 |
msg | string | 否 | 结果说明 |
data | array of object | 是 | 按时间排列的数组，每个元素是一个周期 |
data[].time | integer（int64） | 是 | 周期开始时间，毫秒时间戳（UTC） |
data[].global_account_long_percent | number | 是 | 全部账户中的多单比例，单位 % |
data[].global_account_short_percent | number | 是 | 全部账户中的空单比例，单位 % |
data[].global_account_long_short_ratio | 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 工具里。
想让 AI 直接查询实时数据、不写代码？在 Claude、Cursor 中接入 CoinGlass MCP 后直接用中文提问，例如「Binance 上 BTCUSDT 现在的账户多空比是多少？最近一周是在上升还是下降？」。
应用场景
| 场景 | 说明 |
|---|---|
| 观察散户情绪 | 全部账户多空比反映大多数交易者的方向偏好，比值越高说明持多单的账户越多。 |
| 寻找反向信号 | 多空比长期处于极端高位或低位时，市场往往过于拥挤，可作为反向参考。 |
| 对比大户动向 | 与大户账户数多空比历史对照，看散户和大户的看法是否一致。 |
| 构建量化因子 | 把多空比的变化、偏离均值的程度作为情绪因子，配合价格做回测。 |
相关接口
| 接口 | 区别 |
|---|---|
| 大户账户数多空比历史 | 只统计大户账户，按账户个数计算 |
| 大户持仓多空比历史 | 只统计大户，按持仓量计算 |
| 币种主动买卖比 | 主动买入与卖出的成交额比例 |
| 持仓历史（K 线） | 同一交易对的持仓量变化 |
| 支持的交易所和交易对 | 查询 symbol 的可用写法 |
常见问题
多空比 1.68 是什么意思？
表示持多单的账户数是持空单账户数的 1.68 倍。它只按账户个数计算，不代表多头的资金量是空头的 1.68 倍。
百分比字段 62.62 要不要再乘以 100？
不用。global_account_long_percent 等字段已经是百分数，62.62 就是 62.62%。
为什么换成其他交易所查不到数据？
本接口目前只支持 Binance、OKX、Bybit、Gate、HTX 五家交易所。另外 symbol 要填该交易所的交易对写法，例如 BTCUSDT，而不是 BTC。
为什么返回的条数和 limit 不一样？
同时传 start_time 和 end_time 时，返回条数主要由时间范围和 interval 决定，也会受数据缺失影响，不一定等于 limit。只想要最近 N 条，可以只传 limit，不传起止时间。
深入了解：合约账户多空比
什么是账户多空比？
账户多空比是持有多单的账户数与持有空单的账户数之比。它反映的是有多少人看多、多少人看空，而不是多空双方各投入了多少资金。
多空比高说明要涨吗？
不一定。多空比高只说明看多的账户多。多单过于集中时，价格一旦下跌，容易引发多单集中爆仓。多空比更适合作为情绪参考，需要结合持仓量和价格一起判断。
账户多空比和大户多空比有什么区别？
账户多空比统计全部账户，更接近散户情绪；大户多空比只统计大户，详见「大户账户数多空比历史」和「大户持仓多空比历史」。