获取某个交易所、某个合约交易对的大户持仓多空比历史：大户多单和空单持仓量的比例，以及两者的比值。适合观察大户资金实际押注的方向。
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
以下 API 等级均可调用本接口：业余 初创 标准 专业 企业
不同等级可查询的数据周期不同，详见本页下方的「API 等级与可用周期」。
响应数据
data 为数组，每个元素是一个周期的数据，time 为周期的开始时间。数值以数字返回。这里只统计大户，按持仓量计算：仓位越大的账户，对结果的影响越大。
占比是百分数，多空比是比值
*_long_percent、*_short_percent的单位是 %，62.62表示 62.62%，不需要再乘以 100。有效的多、空占比相加应约为 100；OKX 已知异常见下方说明。*_long_short_ratio是多头占比 ÷ 空头占比，1.68表示多头是空头的 1.68 倍，不是百分数。
OKX 百分比字段存在已确认的异常点OKX 的
top_position_long_percent与top_position_short_percent部分返回值相加明显不等于 100，不能作为有效占比使用。遇到异常点时标记为暂不可用，并保留原始值、时间戳、交易所和symbol供排查；不要自行归一化到 100%、回填历史或根据异常占比重算多空比。top_position_long_short_ratio应单独校验，不因百分比异常而自动改写。
200 · application/json · 响应示例见右侧面板。
| 字段 | 类型 | 必返 | 说明 |
|---|---|---|---|
code | string | 是 | 业务状态码，"0" 表示成功 |
msg | string | 否 | 结果说明 |
data | array of object | 是 | 按时间排列的数组，每个元素是一个周期 |
data[].time | integer（int64） | 是 | 周期开始时间，毫秒时间戳（UTC） |
data[].top_position_long_percent | number | 是 | 大户持仓中的多单比例，单位 %；OKX 部分点存在异常，见上方说明 |
data[].top_position_short_percent | number | 是 | 大户持仓中的空单比例，单位 %；OKX 部分点存在异常，见上方说明 |
data[].top_position_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 的大户持仓多空比最近 24 小时有什么变化？」。
应用场景
| 场景 | 说明 |
|---|---|
| 跟踪大户资金方向 | 按持仓量计算，更能反映大户资金实际押注在多头还是空头。 |
| 发现大户调仓 | 持仓多空比短时间明显变化，说明大户在加多、减多或转向做空。 |
| 与账户数对照 | 与大户账户数多空比历史对比：人数偏多但仓位偏空，说明少数大户重仓做空。 |
| 跨交易所比较 | 同一币种在不同交易所的大户持仓偏向可能不同，可用来观察各平台的资金分歧。 |
相关接口
| 接口 | 区别 |
|---|---|
| 大户账户数多空比历史 | 同样只看大户，但按账户个数计算 |
| 交易对账户多空比历史 | 统计全部账户，更接近散户情绪 |
| 净多持仓与净空持仓 | 净多仓、净空仓的变化量 |
| 持仓历史（K 线） | 同一交易对的持仓量变化 |
| 支持的交易所和交易对 | 查询 symbol 的可用写法 |
常见问题
大户持仓多空比 1.84 是什么意思？
表示大户多单的持仓量是空单持仓量的 1.84 倍，按仓位大小计算，而不是按账户个数。
百分比字段 64.83 要不要再乘以 100？
不用。top_position_long_percent 等字段已经是百分数，64.83 就是 64.83%。
OKX、Bybit 能查所有币种吗？
不能。OKX 只支持 XRP、BTC、LINK、FIL、BCH、ETH、ETC、ADA、LTC、DOT、TRX；Bybit 只支持 BTC、ETH、SOL、XRP、DOGE、TON、LTC、BCH、ADA。Binance、Gate 和 HTX 支持全部币种。本接口只支持这 5 家交易所。
为什么返回的条数和 limit 不一样？
同时传 start_time 和 end_time 时，返回条数主要由时间范围和 interval 决定，也会受数据缺失影响，不一定等于 limit。只想要最近 N 条，可以只传 limit，不传起止时间。
深入了解：大户持仓多空比
什么是大户持仓多空比？
它统计交易所划定的大户中，多单持仓量和空单持仓量的比例。比值大于 1 说明大户整体的多单仓位比空单大。不同交易所对大户的划分标准可能不同。
持仓多空比和账户数多空比哪个更重要？
持仓多空比反映资金量，账户数多空比反映人数。少数大户重仓时两者会出现分歧，这时持仓多空比更能说明大户资金的实际方向。
如何查看全部账户的多空情绪？
使用「交易对账户多空比历史」，它统计该交易对的全部账户。