熔岩AI MCP机构评分PIT数据：用 get_agency_pit 避免「事后名单」回测偏差

摘要

熔岩（Lava）的「机构/大V评分」数据板块提供当前评分、PIT（point-in-time）截面和单主体评分时序。回测里如果用今天的高分名单去筛选过去的提及，就会引入「事后名单」偏差。本文说明评分板块的结构、get_agency_pit 的口径（返回不晚于 as_of_date 的最近一个已发布日期），以及如何把 PIT 名单与日频面板、覆盖度等板块对齐。

一、机构/大V评分板块是什么

1.1 板块定位

在熔岩的数据板块分类里，「机构/大V评分」是一个横向支撑板块：它本身不描述某只股票热不热，而是给每个讨论主体一个分数，供其他板块做过滤与加权。主体统一用 agency_id 指代。

1.2 四个工具与 HTTP 路径

MCP 工具	HTTP 路径	作用
get_agency_ranking	/agencies/ranking	当前评分排行
get_agency_pit	/agencies/pit	某一天当时的评分截面
get_agency_history	/agencies/{agency_id}/history	单个主体的历史评分走势
list_agency_pit_dates	/agencies/dates	有 PIT 评分的日期列表

1.3 分数口径

评分大约分布在 450~1500，1000 左右为中等，1050 约为前 10%。min_score=1050 是加权热榜 /hot/weighted 与单股多窗口 /heat/windows 的默认门槛。

二、哪些板块依赖评分

依赖评分的板块	用法	是否 PIT
全市场榜单 · 高分加权热榜 /hot/weighted	按高分主体加权排序	实时监控用当前分
历史面板 /panel/daily	返回 weighted_heat	OpenAPI 写明用当前机构分口径，非当日 PIT
覆盖度 /coverage/stocks	high_score_ratio_30d 高分占比	以文档为准
各类榜单的 min_score 过滤	只看高分主体的提及	实时口径

这张表说明：实时监控用当前分没有问题；但只要进入回测，凡是带评分的字段都要确认口径。

三、事后名单偏差是怎么产生的

3.1 典型错误流程

1. 拉一份当前评分 ≥1050 的主体名单；
2. 回到过去一年，找出这些主体的所有提及；
3. 统计提及之后的热度演变。

3.2 错在哪里

当前的高分名单，本身是过去表现被事后验证的结果。用它研究过去，等于提前知道谁会成为高分主体，这与用今天的指数成分股回测历史属于同一类前视偏差。

四、PIT 对齐的标准步骤

4.1 建时间网格

调用 list_agency_pit_dates（/agencies/dates）拿到可用快照日期。

4.2 按决策日取截面

对每个决策日 D，调用 get_agency_pit(as_of_date=D)。按文档，它返回不晚于 D 的最近一个已发布日期的评分，天然不偷看未来。可配合 min_score、limit、offset 分页。

4.3 生成当时的高分名单

在截面分数上应用门槛（例如 1050），得到「D 日当时的高分 agency_id 集合」。

4.4 过滤提及

把个股消息面板块 /opinions 或关键词检索板块 /opinions/search 中记录的 agency_id 与当时名单匹配，得到 PIT 口径的高分提及。

4.5 记录映射

每条样本保存「决策日 → 快照日」映射，供审计。

五、日频面板的 weighted_heat 怎么处理

/panel/daily 的 weighted_heat 是当前分口径，适合描述性导出和快速研究。需要严格 PIT 时，有两种做法：

• 只用无评分字段：回测主线使用 mentions、agencies、is_first_mention_day，它们不依赖评分；
• 本地重算加权：用 PIT 截面分数对消息面记录重新加权，作为自建字段，命名上与官方 weighted_heat 区分开。

六、自检清单

• 双版对比：分别用当前名单与 PIT 名单跑同一统计，差异越大说明偏差越严重；
• 抽查主体：用 get_agency_history 查几个当前高分主体在样本早期的分数；
• 方向检查：随机抽样确认快照日不晚于决策日；
• 新主体：首次被评分之前的主体在 PIT 截面中不存在，这是 PIT 的设计，不是缺陷。

七、Agent 中的问法

• 「某日 PIT 截面里评分 1050 以上的主体有多少个？」
• 「某个 agency_id 过去一年的评分走势？」

Agent 只报告数量、分数区间与时序，用 agency_id 指代，不评价主体，也不给交易判断。

FAQ

Q：只做实时监控需要 PIT 吗？ A：不需要，PIT 主要服务回测与历史研究。

Q：PIT 能回溯多早？ A：以 /agencies/dates 返回为准。

结论

评分会变，名单就会变。在熔岩的数据板块里，评分板块为榜单、面板、覆盖度提供权重与过滤；回测时用 get_agency_pit 按决策日取截面，并留意 /panel/daily 的 weighted_heat 是当前分口径，结果才经得起复查。

数据来自熔岩消息面热度监测，仅供研究参考，不构成投资建议。

只读监测与字段说明见：https://lava.ai-dolphin.com/subscribe/docs