获取某个交易所、某个合约交易对的大户账户数多空比历史：大户中持多单和持空单账户的比例，以及两者的比值。适合观察大户的方向偏好。
| 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[].top_account_long_percent | number | 是 | 大户账户中的多单比例，单位 % |
data[].top_account_short_percent | number | 是 | 大户账户中的空单比例，单位 % |
data[].top_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 的可用写法 |
常见问题
大户账户数多空比和大户持仓多空比有什么区别？
账户数多空比按大户的账户个数计算，每个账户算一个；持仓多空比按大户的持仓量计算，仓位大的账户影响更大。两者可能出现方向不同的情况。
百分比字段 64.31 要不要再乘以 100？
不用。top_account_long_percent 等字段已经是百分数，64.31 就是 64.31%。
为什么换成其他交易所或币种查不到数据？
本接口目前只支持 Binance、OKX、Bybit、Gate、HTX 五家交易所。其中 OKX 只支持 XRP、BTC、LINK、FIL、BCH、ETH、ETC、ADA、LTC、DOT、TRX；Bybit 只支持 BTC、ETH、SOL、XRP、DOGE、TON、LTC、BCH、ADA。另外 symbol 要填该交易所的交易对写法，例如 BTCUSDT，而不是 BTC。
为什么返回的条数和 limit 不一样？
同时传 start_time 和 end_time 时，返回条数主要由时间范围和 interval 决定，也会受数据缺失影响，不一定等于 limit。只想要最近 N 条，可以只传 limit，不传起止时间。
深入了解：大户账户数多空比
什么是大户账户数多空比？
它统计交易所划定的大户中，持多单账户和持空单账户的比例。比值大于 1 说明看多的大户更多。不同交易所对大户的划分标准可能不同，跨交易所比较时请注意。
为什么要单独看大户？
大户资金量大，他们的方向偏好常被当作比散户更有参考价值的信号。大户和散户方向相反时值得留意，但这只是参考，不能单独用来判断涨跌。
如何查看大户的实际仓位偏向？
账户数只反映人数，要看仓位大小请使用「大户持仓多空比历史」。