(1) 按 ccy 汇总交割与永续合约的净多账户数 / 净空账户数;(2) 按 instId 统计某一合约的净多账户数 / 净空账户数;(3) 同一合约中持仓价值前 5% 的 Top Trader 账户比;(4) 同一合约中 Top Trader 多头持仓价值 / 空头持仓价值。OKX 没有在这组接口里提供所谓全市场持仓比。
币种账户比跨交割与永续汇总,其余三条按指定合约统计;Top Trader 两条又只看持仓价值前 5% 的账户。样本、参数和分母不同,同一时间出现不同读数很正常。账户比本身也不能证明资金净流入或新增买卖盘。
先写清 endpoint、ccy 或 instId、周期和采样时刻,再与同一口径的历史分布比较。比率大于 1 只表示该样本中分子大于分母,小于 1 则相反;2.5、0.5 等都不是 OKX 官方交易阈值。
不能。OKX 将它定义为某币种交割与永续合约的净多账户数 / 净空账户数,并未把样本标成散户。是否存在反向信息必须用同一接口与参数另做可复现检验。
它描述指定合约中持仓价值前 5% 账户的多空持仓价值分布,适合用来观察这一样本,但不是方向信号。榜单按仓位价值筛选,没有胜率筛选;仓位大不代表判断更准。
先确认两条数据是否来自同一 instId。若同一合约的 Top Trader 账户比高于 1、持仓比低于 1,只能说明净多账户较多、而空头持仓价值较大;它不能单独证明谁在加仓、减仓或下一步价格方向。
保存 endpoint、参数、原始响应、采样时刻和当时的价格、成交量、资金费率及持仓量,事后按固定窗口检验。LSR 只描述样本分布,不能代替交易计划,也不能因为与其他指标同向就自动变成入场或止损指令。
同一个「多空比」,OKX 其实给了你四张不同的表
OKX Rubik 公开接口里有 4 个容易混淆的口径。它们不是同一总体的四种切片,参数和样本必须一起看:
1. Long/Short Account Ratio(币种账户比):用 ccy 查询,统计该币种交割合约与永续合约中净多账户数 / 净空账户数。这是跨两类合约的账户数汇总。
2. Long/Short Account Ratio by contract(单合约账户比):用 instId 查询,只统计指定合约里的净多账户数 / 净空账户数,例如 BTC-USDT-SWAP。
3. Top Trader Long/Short Account Ratio:同样按 instId,但样本只保留持仓价值最大的前 5% 账户,比较其中净多与净空账户数。
4. Top Trader Long/Short Position Ratio:还是同一指定合约与同一 Top Trader 样本,比较多头持仓价值与空头持仓价值。这是四个接口里唯一按持仓价值相除的口径。
因此不能把第 2 条写成「全平台持仓比」。比较读数时也要先对齐币种、合约和时间;账户比只能描述当时的账户分布,不能单独证明新增买盘、卖盘或资金流向。
OKX API 文档可以在 www.okx.com/docs-v5/en/ 找到,具体端点稍后实操。
账户比数的是人头,持仓比数的是 USD
账户比的特点是 — 一个 100 USDT 仓位和一个 10,000,000 USDT 仓位,在账户比里都只算一个账户。它描述账户数量,不描述资金规模。
持仓比则按持仓价值比较,但这组 OKX 接口里的持仓比只覆盖指定合约的 Top Trader 样本,不能与币种账户比当作同一总体直接配对。
如果比较同一 instId 的 Top Trader 账户比与持仓比,可以这样描述:
- 账户比 1.8 + 持仓比 0.9 → 净多账户较多,但空头持仓价值更大
- 账户比 0.9 + 持仓比 1.5 → 净空账户较多,但多头持仓价值更大
- 账户比 1.0 + 持仓比 1.0 → 双方都平衡,无明显信号
这些组合只描述分布,不能仅凭比率判断哪一边更会交易或下一步价格方向。
Top Trader 的筛选条件与信息边界
Top Trader 的定义写在 OKX API 文档里,一句话:持仓价值最大的前 5% 账户(原文「the top 5% of traders with the largest open position value」)。排的是持仓价值,不是 30 天成交量,也不是盈亏 — 这点常被写错,连带把「他们更会交易」当成了定义的一部分。
把这批账户单独抽出来,是为了让你看到「体量最大的一批仓位在哪一边」。但要说清楚:仓位大不等于判断对。这个口径里没有任何胜率筛选,一个刚建了大仓的账户和一个拿了三个月的账户,在榜单上是一回事。
所以 Top Trader 两条线和币种账户比、单合约账户比不能直接互换:它们的样本与参数不同。至于哪条线「更准」,官方没给过这类统计,任何「提前多少小时发出信号」的说法都得先拿出可复现的数据,否则只是事后挑出来的几次。
没有 Top Trader 筛选的账户比也不能直接叫作「散户比」。OKX 只说明它统计净多与净空账户,没有为这些账户标注身份。两类样本可以并列观察,但不能包装成散户与大户的对决。
怎样读高低值而不制造因果
把 4 种 LSR 画在同一条时间轴上,你会发现它们各有各的「常态位置」。下面这组描述是盘面上常见的判读习惯,不是官方口径,也不是从哪份统计里回归出来的 — 拿它当起点,真正属于你的阈值要用自己拉的那段历史来定(怎么拉见下一节):
币种账户比:跨交割与永续统计账户数量。只有保存了同一币种、周期和参数的历史,才谈得上读数位于自身分布的什么位置。
单合约账户比:只看一个 instId 的账户分布,与跨交割和永续汇总的币种账户比不是同一条线。
Top Trader 账户比:只统计指定合约中持仓价值前 5% 样本的账户数量,不能从样本大小推断它一定比其他序列更灵敏。
Top Trader 持仓比:比较同一指定合约、同一样本的多空持仓价值。读数变化本身不能区分开仓、平仓、对冲或样本成员变化。
关键在于:不同接口的历史分布可能不同,不能把同一个数值阈值机械套到币种、合约和 Top Trader 三种样本上。
比率越靠两端,只能说明该口径下多空分布越不对称。它不直接测量新增资金或成交方向,也不保证随后反转。至于「极端之后几天内回调的概率是多少」,必须用同一接口、同一参数的历史数据做可复现统计。
关于「反向投资」(contrarian)的理论基础,Investopedia 的 Contrarian 词条讲了它的思想史。
仓位风险要与 LSR 分开计算。纯假设如下:以 70,000 USDT 买入 Q=0.05 BTC,价格随后到 63,000,忽略手续费与资金费,多单毛损益为 Q × (63,000 − 70,000) = −350 USDT。
若在价格仍为 70,000 时平掉一半,平仓部分在本假设中实现损益为 0,剩余 Q=0.025 BTC 的同一跌幅毛损益为 −175 USDT。这个比较只说明固定价格路径下数量减半会令线性损益减半;它没有使用 LSR 预测价格,也没有断言减仓一定正确。
强平还需要逐仓或全仓模式、保留保证金、维持保证金率、费用等输入。若仓位数量与保证金一起减半,单位仓位保证金不变,强平边界不会因为「半仓」二字自动改善;仅调整界面杠杆也不等同于真实减仓或追加保证金。
用 OKX API 把实时 LSR 拉到自己机器上
OKX 公开 API(docs-v5,rubik 那一组)提供这些数据的端点,不需要 API key。注意参数不是同一套:币种账户比按 ccy,单合约和 Top Trader 口径按 instId。
币种账户比(交割 + 永续):/api/v5/rubik/stat/contracts/long-short-account-ratio?ccy=BTC&period=5m
单合约账户比:/api/v5/rubik/stat/contracts/long-short-account-ratio-contract?instId=BTC-USDT-SWAP
Top Trader 账户比:/api/v5/rubik/stat/contracts/long-short-account-ratio-contract-top-trader?instId=BTC-USDT-SWAP
Top Trader 持仓比:/api/v5/rubik/stat/contracts/long-short-position-ratio-contract-top-trader?instId=BTC-USDT-SWAP
几个会绊人的限制,照文档写:币种账户比的 period 支持 5m / 1H / 1D,回看窗口分别为 2 天 / 30 天 / 180 天,限速是每个 IP 5 次 / 2 秒。三个合约接口可检索最近 1,440 条,但每次请求的 limit 默认和最大值都是 100;限速是每个 IP + instId 5 次 / 2 秒。Top Trader 数据从 2024-03-22 起才有。
返回的是 [[timestamp, longShortRatio], ...] 这样的二维数组。哪一头是最新一条,拉一次把时间戳打出来看最直接,别按感觉假设。另外官方页面没有写这些统计的更新频率,所以也别把「每 5 分钟一定有新值」写死进轮询逻辑里。
币种账户比的 5m 窗口只有 2 天;三个合约接口则按各自最近 1,440 条、单次最多 100 条及分页条件取数。要研究更长区间,应提前把每条序列按自己的 endpoint 与参数分别归档,不要把币种接口的 2 天限制泛化到全部序列。
也可以打开本站的多空比数据页,同时查看 BTC 和 ETH 的币种账户比、Top Trader 单合约账户比与持仓比,每张卡显示约 150 分钟的 5 分钟序列。
没有原始快照时,怎样核查历史说法
本站没有保存足以复核旧行情叙述的原始 API 响应,因此不继续复述具体日期、价位、比率轨迹或哪类账户做对了。记忆中的面板形状不能当作实证。
一段合格的历史核查至少要保存:
- 完整 endpoint、
ccy/instId、period、分页参数和 UTC 采样时刻; - 未经改写的响应或带时间戳快照,以及同期价格、成交量、资金费率与 OI;
- 预先写好的观察窗口与评价规则,包括如何处理缺失值和重复样本;
- 只报告比率能够支持的分布变化,不把它翻译成某类账户的开仓、平仓、强平或盈利。
没有这些材料时,能做的是提出待验证假设,不能补上精确数字或方向故事。
不同样本读数背离时,先核对口径
假设币种账户比为 1.9,某合约 Top Trader 持仓比为 0.6。这只能说明跨交割与永续的账户数量分布偏向分子一侧,而指定合约的 Top Trader 持仓价值偏向分母一侧。两条线的总体、参数和计量单位都不同。
遇到背离时依次核对:
- 是否为同一币种和可比较的合约,时间戳是否对齐;
- 比较的是账户数量还是持仓价值,是否使用 Top Trader 样本;
- 比率变化来自哪一侧无法由比率本身识别,需另查绝对量或其他数据;
- 任何方向、期限或交易动作都应作为另行检验的假设,不能由背离直接给出。
比率相同也不代表参与规模相同:净多与净空账户数同时翻倍,比率仍可不变。持仓比上升也可能是多头增加、空头减少,或两边同时减少但空头降得更快。
把多空比变成可复核的研究记录
LSR 最适合做结构化观察变量。每次采样保存接口、参数、原始值和 UTC 时间,再独立记录价格、成交量、资金费率与 OI。资金费率、OI 和 LSR 各自测量不同东西,同向不自动形成交易信号。
在看结果之前写清假设:例如「指定合约 Top Trader 持仓比进入自身过去 30 天的上十分位后,未来 24 小时收益分布是否变化」。随后固定样本、窗口、手续费假设和缺失值规则,同时保留没有出现预期结果的样本。
这种记录可以回答某个阈值在你的数据里是否有信息量。单张快照只能回答当时的相对分布,不能替你决定入场、止损或仓位。