持仓与拥挤度方法论

摘要。 Macro Terminal 从 CFTC 交易商持仓报告（Commitments of Traders，COT）中读取期货持仓，并将其转化为两样截然不同的东西：一条 净持仓 序列，说明投机资金正倒向哪一边；以及一个 拥挤度 指标，说明这种倒向相对其自身历史有多不寻常。本页记录这些序列背后的口径选择——哪一类资产使用哪个 COT 报告族、哪个交易者分类算作投机者代理口径、净持仓如何标准化、拥挤度 z 分数如何定义（逐成员、带符号、稳健口径、单一 canonical 窗口）、数据更新频率如何，以及覆盖哪些资产族。我们的目标是：读者无需询问我们做了什么，就能凭公开的 CFTC 数据复现这里的每一个数字。

1. 为什么持仓要单列一层

多数宏观指标描述的是 世界的状态——增长、通胀、流动性、信用。持仓描述的是 市场对这个世界所下赌注的状态。两者回答的是不同的问题，把它们混为一谈是最经典的错误。

Macro Terminal 把持仓视为脆弱度指标，而非方向信号。拥挤的持仓不会告诉你趋势错了；它告诉你价格对反向催化剂有多敏感——一次库存意外、一场天气事件、一轮美元波动、一个不及预期的数据。净多头极端、身后却没有新增未平仓合约支撑的趋势，比同样的价格走势叠加参与度扩张要脆弱得多。

这对数据如何接入有直接影响：持仓序列是证据与背景，而不是打分输入。它们可以限定或封顶某个资产观点的信心度；它们本身不产生观点。

2. 用哪个 COT 报告族，以及为什么

CFTC 针对同一批标的市场发布多个并行的报告族。它们对交易者的分类方式不同，因此这些分类不可互换，其历史序列也绝不可拼接。

Macro Terminal 按资产领域选择报告族，而不是采用某个通用默认值：

刻意排除的报告族

• Legacy（传统报告）。 Legacy 的商业/非商业划分与 TFF 或 Disaggregated 的分类不可比。把它掺进来需要额外搭一座分类桥梁，只会增加解释上的模糊性，而没有分析收益。持仓层的任何环节都不使用 Legacy。
• 商品指数交易商补充报告（Supplemental CIT）。 CIT 回答的是另一个问题——指数跟踪型敞口——它不是管理基金的替代品。我们的处理是将其排除在范围之外，而非混入。

只用仅期货，绝不用合并口径

所有持仓序列均使用仅期货（futures-only）数据。不使用期货与期权合并数据，且仅期货观测与合并观测绝不在同一条指标历史内混用。

理由在于可解释性：合并文件把期权头寸折进持仓计数却不披露 delta，于是一个"净多头"数字就混合了直接敞口与方向权重未知的期权衍生敞口。仅期货口径以忽略期权为代价换取序列的干净——对一个脆弱度指标而言这是可接受的交换，因为分布的形状比最后那一单位敞口更重要。

所用数据集：

两者均由 CFTC 公开报告环境（Public Reporting Environment）提供，且无需 API key。

3. 交易者分类

在每个报告族内部，只保留一个明确界定的交易者分类子集。

TFF（金融合约）

• 杠杆基金 —— 投机者代理口径。交易金融期货的对冲基金、CTA 以及管理基金类账户。
• 资产管理机构在数据源中可得，也可作为背景信息呈现，但它不是证据级分类。

Disaggregated（实物合约）

• 管理基金 —— 投机者代理口径。趋势跟踪者、CTA 和宏观基金。
• 生产商/贸易商/加工商/终端用户 —— 商业套保方。解读为实物套保压力；通常与管理基金方向相反。
• 互换商 —— 指数挂钩与场外对冲流。解读为金融中介与结构性配置敞口。

证据级分类仅限投机者代理口径。 管理基金（Disaggregated）与杠杆基金（TFF）是能够把持仓证据带入资产观点的分类。生产商/贸易商与互换商属于展示与背景：它们能丰富对管理基金极端值的解读，但不独立生成证据。

由于两个报告族的投机者分类承担相同的分析角色，Macro Terminal 将其视为同一个分类槽位——TFF 合约对应杠杆基金，Disaggregated 合约对应管理基金——并逐合约注明，确保这一区分不会丢失。

4. 净持仓：定义与标准化

对于给定的合约与交易者分类：

net       = long − short
netPctOi  = (long − short) / open_interest_all × 100

存储的序列是 netPctOi，以占未平仓合约的百分比表示。

为什么用未平仓合约做标准化。 原始的净合约张数在不同合约之间不可比（铜的 40,000 张净多头与玉米的 40,000 张净多头含义完全不同），在同一合约的不同时期之间也不可比，因为市场规模会漂移。除以总未平仓合约后，序列变成了 占市场的份额——既可跨合约比较，也足够接近平稳，使得历史 z 分数具有意义。

跨期对锁持仓（spreading）不计入 net。 它们在构造上就是方向中性的；把它们加进来只会虚增表面头寸而不增加任何方向性敞口。它们可以作为数据质量的背景字段保留，但绝不进入 net。

未平仓合约的完整性是一道硬闸门。 如果某合约的 open_interest_all 缺失、为零或不可靠，该指标保持待定状态。不存在退回原始净合约张数的兜底方案——一条未经标准化的序列会悄无声息地摧毁整个持仓层所依赖的可比性。

4.1 最新周变化：分子与分母

最新周分解把报告中的净持仓占比变化拆成净合约项与 OI 分母项。令 p 为以百分数表示的 netPctOi，不是小数比例；N 为净合约张数，OI 为总未平仓合约。下标 0、1 分别指上期与最新一期观察：

N0 = p0 × OI0 / 100
N1 = p1 × OI1 / 100
A = 100 × (N1 − N0) / OI1
B = p0 × (OI0 / OI1 − 1)
Δp = p1 − p0 = A + B

A 是净合约项，B 是 OI 分母项，单位都是百分点（pp）。净合约项使用当期 OI（OI1）作分母；分母项则固定上期净合约张数，衡量 OI 改变时的比例差。这是一种代数分摊约定。其他有效约定可能把交互部分分配到不同项，但总差仍为 p1 − p0；分项不识别彼此独立的经济原因。

分母变化可能让占比与净合约张数方向相反。任何一项都不衡量现金流、不证明价格因果，也不新增交易信号。净合约是 long − short：它的变化不能区分多头增加与空头减少，更不能还原多空两端各自的变化。仅凭 OI 不能确认移仓。这里使用仅期货报告，总 OI 覆盖报告中的各期货到期月份，不是只覆盖近月。杠杆基金持仓不等于全体投资者的股票敞口；利率期货持仓方向不等于收益率方向，外汇期货方向也不是现货货币对的交易建议。

4.2 适用范围、展示与可用性

计算仅用于明确配对的 23 个单合约序列，每条序列保留各自的报告族与交易者分类：

族级平均值、拥挤度 z 分数、独立 OI 详情与 CHECK 均排除。 成员占比的平均值乘聚合 OI，不能还原篮子的净合约张数。拥挤度别名即使共用一条源序列，也不因此成为单合约净持仓序列。

持仓总览的适用卡片提供周变化折叠区；适用指标的详情页在图表／统计区域下方直接展示相同四项读数，计算方法与边界另行折叠。它们描述的是该指标返回的最新两个观察，不是图表所选区间：切换 3 个月或 5 年，不会把分解改为那个窗口首尾的变化。所列日期是观察日，不是发布日期；获取时间与观察日均不能证明历史市场可知时间或报告的修订版本。

两条序列的日期必须有效且不重复，数值必须有限；OI 必须为正的安全整数。返回输入中任一非法行都会使分解失效。两边各自的最新两个日期必须精确相同，且两期恰好相隔七天。不退回旧的可匹配配对，不前填、不插值，也不自行推定节假日调整。输入缺失或非法时撤下数字，保留不可用说明。详情响应还须与声明的主序列及 OI 序列身份一致。详情任一请求正在检查或更新失败时，撤下缓存中的分解数字；成功刷新后即使数值未变，也可以恢复显示。这不改变全站其他读数的已保存快照策略。

界面将百分点显示到小数点后三位，推算的净合约变化显示到整数张并标为近似值。N = p × OI / 100 是从已存储占比还原张数，精度会继承占比本身的舍入。分项各自舍入后，不必恰好相加为舍入后的总差。这些显示规则不改变底层序列、拥挤度窗口或评分方法。

4.3 固定的铜历史样例

本例是历史示例，不是当前读数，使用已冻结、经原始来源核对的铜管理基金仅期货观察，区间为 2026-09-15 → 2026-09-22：

净合约增加 17,416 张。按当期 OI 分摊约定：

占比变化 = +4.864241929 pp
净合约项 = +5.773444674 pp
OI 分母项 = −0.909202745 pp

界面读数为 +4.864 百分点、+5.773 百分点、−0.909 百分点及 ≈ +17,416 张。OI 扩张使占比变化小于净合约项的贡献。这组算术不能告诉我们究竟是多头增加、空头减少、发生了移仓，还是这些持仓导致了价格变化。

5. 拥挤度：逐成员带符号 z 分数

这是最常被搞错的定义，因此在此精确陈述。

拥挤度 = 单一合约的管理基金（或杠杆基金）netPctOi 的带符号稳健 z 分数，在滚动 260 周（5 年）窗口上计算。

这句话推出三条性质，每一条都是承重的。

5.1 带符号，而非绝对值

z 分数保留其符号。高正值 z 代表多头拥挤；极端负值 z 代表空头拥挤。这是两种不同的市场状态，失效方式也不同——拥挤的多头通过获利了结和止损出局来消化，拥挤的空头则通过空头回补挤压来消化。取 |z| 会把两者压缩成同一个"极端"读数，把信息彻底破坏掉。

5.2 逐成员，而非混合合成值

拥挤度按合约计算和展示。一个商品族的拥挤度视图是一组各自独立的带符号 z 曲线——黄金、白银、铜、铂、钯——而不是一个代表"金属"的平均数。

在族内对 z 分数取平均会掩盖分化，而分化恰恰是最有信息量的情形：黄金多头拥挤、同时铜空头拥挤，与两者都轻微偏多，是截然不同的宏观陈述，然而等权合成值会把这两种情况呈现得一模一样。这也正是金属不设单一族级拥挤度数值的原因——黄金作为货币/实际利率资产交易，铜作为周期需求资产交易，一个混合的"金属拥挤度"数字会断言一个并不存在的共同驱动。

在保留族级合成值的地方，其范围被限制在成员合理共享驱动的同质篮子——谷物（玉米、小麦、大豆）与软商品（咖啡、可可、糖）。即便是这些合成值也附带同质性保留条款，并且是与逐成员曲线并列阅读，而非取而代之。

这样的合成值恰好只有两条——农产品一条、软商品一条——且都是组内成员带符号 z 的等权平均。保留符号，合成值才能被读作拥挤方向而不仅是紧绷程度：为正是净多篮子，为负是净空篮子。该合成值刻意不做二次标准化——z-score 的平均本身就在 z 轴上，再套一层 z 回答的是"这个合成值对它自己是否异常"，而那不是我们要问的问题。对相关成员取平均仍会压缩离散度，因此族级合成值触及某一带宽会比任一单一成员更晚；它与成员曲线是并列阅读，而非取而代之。金属、能源与畜牧不存在任何合成值。

2026 年 8 月之前，这两条合成值的定义正好相反：它们取的是成员 |z| 的平均，因而只是幅度计——空头拥挤与多头拥挤记为同一个数，其符号衡量的是离篮子自身常态的距离而非方向。这两条序列（cftc-ags-crowd、cftc-softs-crowd）只读保留，历史仍在各自的指标页上呈现，但已无任何写入路径，也不再被任何资产卡读取。它们与取代它们的带符号合成值是不同的量，两者绝不可互相替代。

5.3 等权合成值只有一个合法归宿

混合型拥挤度数字确实有一个正确的位置：跨族系统性总览层——在那里，各商品族（能源、金属、农产品、软商品、畜牧）的管理基金 z 均值被并排比较，用以回答"当下哪一族最拥挤"。这是一个决定往哪里下钻的分诊工具。它属于凌驾于各族之上的系统层——绝不属于任何单一族的卡片内部，因为在那里它会取代它本应概括的逐成员细节。

5.4 窗口

拥挤度窗口为 5 年，以 260 个周度观测实现。CFTC 是规整的周度数据，因此固定的行数就是一个精确的日历窗口而非近似——无需也未使用任何日期感知的插值。窗口不含当前点，且 z 以稳健口径计算——对照窗口的中位数与 MAD（乘以 1.4826），而非均值与标准差——随后在 ±4 处缩尾，使一次持仓的极端爆发无法撑大后续每一个读数所对照的那把尺子。

5 年是一个刻意的折中。足够长，使分布覆盖不止一个持仓周期，也使 MAD 足够稳定；又足够短，使参照分布仍反映当前的市场结构、参与者构成与合约规模。窗口若长得多——极限情况即全历史——就会拿今天的持仓去对照一个已经不复存在的市场打分，而管理基金占未平仓合约的比例在数十年尺度上的漂移大到不可忽略。更短的窗口则在另一个方向上被否决：那样长度的窗口可能整段落在同一个持仓周期内部，z 分数便什么也没在衡量。

持仓序列的 z 分数视图与百分位视图使用的是同一个 260 周窗口，因此拥挤度读数与由其派生的证据级信号绝不会在不同的历史长度上计算。

一条文档化例外。 CHECK 板上的金属拥挤度图表不按上述口径计算。它使用 260 周滚动均值与总体标准差——这是从原始 PDF 研究反推出来的估计量，使已发布的图表能与那份研究逐值对齐（"Platinum 1.00 exact"锚点）。窗口长度完全相同，估计量不同。读者若拿 CHECK 金属图表与同一合约、同一日期的拥挤度 z 做对照，应当预期两个数字不一致，这个差异来自估计量而非数据错误。这是全站唯一一条此类例外：其余所有拥挤度序列都使用上文的中位数／MAD 定义。

5.5 方向语义：反向（contrarian）

拥挤度以反向语义进入资产证据：

• 高多头百分位 / 高正值 z → 该交易已拥挤 → 映射为 pressure（压力）。
• 出清或净空百分位 / 极端负值 z → 持仓风险已释放 → 映射为 support（支撑）。

这些序列不再对 conviction 施加任何惩罚。 拥挤腿在任何方向上都不被允许支持资产卡片的偏置，而自 v3.0.0-alpha.11 起，它也不再压低该卡片的 conviction。取而代之的是在卡面挂出一个带符号的脆弱度标签：拥挤在哪一侧（多头／空头，读的是该腿带符号净持仓的符号）、有多紧绷（达到带宽为拥挤，达到带宽两倍为极端拥挤，两个边界都取闭区间），以及这份拥挤是落在卡片自己这一侧（同向——论点即拥挤交易，平仓冲击直指该观点）还是对手方（反向——对手方平仓反而是顺风）。

有两条限定，二者在此前被隐式处理时都是错的。由成员 |z| 构成的合成序列不带方向：它们的符号衡量的是篮子离自身常态的距离，而不是交易方向，这类腿只能挂档位——不挂方向，也不挂同向／反向。正是这条限制让农产品与软商品最初的分组合成序列退役：自 2026 年 8 月起，两张卡改读第 5.2 节的带符号族级合成序列，因此如今每张卡上的每条拥挤腿都带真实方向，"无方向"分支只是保险机制而非现实情形。以及，"多头拥挤对应哪个卡片方向"由每条腿显式声明，绝不假定："多头拥挤 ⇒ 看多卡"这个恒等式只在卡片收益轴与合约价格轴一致时成立。曲线陡峭化卡读的是 10 年期国债期货净持仓，收益来源却是 2s10s 斜率，所以在那张卡上，空头拥挤（其回补买入 10 年期、压平曲线）才是同向且危险的一侧——与读取同一条序列的久期卡正好相反。

改为"挂标签"而非"扣分"的理由：一档 conviction 降级会把同向拥挤与反向拥挤渲染成同一个结果，而这两件事几乎相反。因此 conviction 保持为纯粹的证据陈述，持仓脆弱度独立成为自己的通道。完整定义见资产映射方法论第三节。

上面的 pressure / support 标签维持原定义不变——它在证据分类层面描述持仓落在哪一侧，也正是脆弱度标签中 side 的来源。

趋势确认语义——把净多头上升读作看涨确认——对拥挤度序列明确不予授权。若某条持仓序列确实需要承担趋势确认角色，它必须是一个单独定义的指标，而不是对拥挤度序列的重新诠释。

6. 未平仓合约

未平仓合约承担三个角色，以及一个明确的非角色。

角色：

1. 每条净持仓序列的标准化分母（见 §4）。
2. 数据质量校验——缺失或不合理的 OI 值会使该合约当周的持仓读数失效。
3. 参与度背景，以未平仓合约同比（52 周变化）的形式呈现。

非角色： 单独的未平仓合约绝不作为资产证据，也绝不作为打分输入。它仅用于展示与背景。

OI 同比提供参与度背景。价格上涨伴随 OI 扩张，与未平仓参与度扩大相容，但不能证明现金流入或看涨确认：每一张新增未平仓合约同时存在多头与空头。价格上涨但 OI 收缩，可能与空头回补或头寸减少相容，却不能据此识别具体机制。OI 扩张而价格停滞，可能反映不同敞口，并不确立未来的价格方向或波动结果。这些都只是候选解释；区分新增多头、新增空头、平仓或移仓，需要价格与总 OI 之外的证据。

7. 序列架构

持仓指标分为三层。只有第 1 层被抓取并存储；第 2、3 层由其计算得出。

把拥挤度保持为已存储原始持仓的派生量而非单独存储的序列，是一条刻意的设计规则，带来两项收益：不产生重复数据；以及无需重新抓取任何一行历史数据即可重新调校或复核拥挤度窗口。只有原始 L1 序列需要历史回填，且回填至少 5 年，使拥挤度窗口从第一天起就是满的。

序列标识符遵循统一约定：持仓用 cftc-<contract>-<category>，未平仓合约用 cftc-<contract>-oi，族级聚合用 cftc-<family>-<metric>。凡使用拥挤度标识符之处，它都是一个指向对应投机者序列 z 分数的标签——它绝不代表另一个被单独存储的值。

8. 更新节奏与新鲜度

CFTC 持仓是带有结构性报送滞后的周度数据。这不是一个需要靠工程手段绕过的缺陷；这是数据集本身的属性，必须让读者看得见。

这在实践中意味着什么。 当一个持仓读数可见时，它描述的是上一个周二的市场。那个周二到当下之间的任何价格波动都不在这个数字里。对于一个以 5 年分布为参照的脆弱度指标而言，这通常是可以容忍的——拥挤度是以周为单位累积的——但这使持仓不适合用作快速触发器，也意味着这几天之内的一次急剧波动可能已经改变了图景。

处理规则：

• 以 CFTC 报告日为观测日期。不合成任何发布时间戳，因为数据源并未稳定地暴露这一信息。
• 若某个已映射合约不存在当期数据行，则省略该项证据，并将缺口报告为数据缺失。绝不静默沿用上期数值。
• 缺失的周度发布绝不从非官方或第三方镜像回填。官方数据里的缺口就保持为一个可见的缺口。
• 超过 14 天阈值后，序列被标记为过期，而不是当作当前数据呈现。

9. 合约映射与资产族覆盖

每一条上线的持仓序列都被钉死到一个精确的 CFTC 合约上：数据集、合约市场名称、合约市场代码、交易所、仅期货口径，以及具体的多头/空头/未平仓合约字段名。没有任何一条是靠名称模糊匹配得来的。这件事的重要性超出字面——单单一个指数在 CFTC 就有多条近乎同名的数据行（合并版本、行业分项、微型合约、股息合约），而它们承载的持仓完全不同。

两个体现钉死纪律的实例：

对 S&P 序列而言，排除项与纳入项一样明确：S&P 500 Consolidated、S&P 行业合约、股息指数合约、S&P 400、S&P GSCI、Micro E-mini S&P 500，以及纳斯达克/道指/罗素/VIX 合约全部排除。对 WTI 而言，Brent、ICE WTI、金融与日历互换数据行、e-mini 原油以及成品油合约全部排除。

覆盖面

每个实物商品族都通过同样的五个维度呈现，这正是它们能够跨族比较的原因：

1. 管理基金净持仓 / OI —— 投机方向
2. 生产商/贸易商净持仓 / OI —— 商业套保压力
3. 互换商净持仓 / OI —— 指数与场外对冲敞口
4. 未平仓合约同比 —— 参与度
5. 拥挤度 —— 管理基金净持仓 / OI 的逐成员带符号稳健 260 周 z 分数

外汇持仓序列作为展示与背景呈现，而非资产证据。货币的方向性标注存在真实的歧义——一个"拥挤的美元多头"同时就是若干其他货币上的拥挤空头——本层不会去断言一个自身无法干净定义的 pressure/support 读数。同理，多期限的利率持仓是逐合约阅读，而非合成为一个久期加权篮子，因为把 2 年、10 年、长债和 SOFR 持仓压缩成一个数字需要一个权重选择，而那将是一个假设，不是一次测量。

10. 五个维度如何合起来读

这些维度被设计为成组阅读。单看每一个都很弱；合起来才有分辨力。

• 管理基金净持仓占比上升、价格上涨、OI 扩张 —— 是参与度支撑趋势的一种候选解释，不自动确认趋势或评定质量高低。应核对推算净合约变化，并在分项可得时结合单独报告的多空变化与价格验证；占比本身也可能随分母改变。
• 管理基金净持仓极端、价格停滞 —— 可能存在获利了结的脆弱性，却不能证明边际买家已经耗尽。仅凭净持仓无法识别剩余买家或多空两端各自的变化。
• 管理基金净持仓极度偏空 —— 任何供给冲击或美元反转都可能触发一轮快速的空头回补。拥挤的空头崩解起来极为剧烈。
• 生产商/贸易商净空扩大 —— 价格上涨之后套保压力在累积。这不构成即时利空，但会削弱价格继续单边上行的弹性。
• 互换商与管理基金同向扩张 —— 可能体现报告中金融持仓方向一致，不证明指数基金现金流入或其对价格的推动。二者背离时，应对照实物库存、期限结构及独立的资金流证据核查。
• 拥挤度极端而 OI 不予确认 —— 不要把宏观观点外推到单个合约上。这正是持仓最常推翻自上而下论断的情形。

一条长期有效的告诫，之所以重述是因为这是最常见的误用：拥挤度衡量的是脆弱度，不是方向。 高 z 分数不是卖出信号。它说明这笔交易已成共识，因而价格对任何与之矛盾的信息都会反应得比平常更剧烈。

11. 适用范围边界

• 持仓序列仅通过资产证据与展示界面进入产品。它们不是宏观状态打分（macro regime scoring）的输入，也不是美元流动性指数（Dollar Liquidity Index）的输入。
• 只有投机者分类（管理基金 / 杠杆基金）是证据级的。生产商/贸易商、互换商以及单独的未平仓合约均属背景信息。
• 持仓可以对某个资产观点的信心度封顶或加以限定；它本身不确立观点。
• 每个被提升上线的合约，其数据集、市场名称、市场代码与字段名都必须在上线前对照 CFTC 实时元数据完成核验。没有任何序列是通过名称匹配推断出来的。