板块与三类信号

板块是 API 的最终研究单位。政策热度、市场关注和资金确认是三个独立信号维度。

板块目录

GET /api/gendangzou/sectors
GET /api/gendangzou/sectors/{sector_id}
GET /api/gendangzou/sectors/{sector_id}/graph

• sector.list 支持按层级、父级、状态和名称搜索。
• sector.detail 返回定义、边界、层级、生命周期和当前信号。
• sector.graph 返回选中板块的一跳层级、产业、演化和市场关系。

板块 ID 是稳定引用。名称变化、层级演化或长期目录更新应通过板块生命周期和关系解释， 不要只用名称做历史连接。

连续实时信号

GET /api/gendangzou/realtime?window=24h
GET /api/gendangzou/realtime/sectors?window=24h
GET /api/gendangzou/realtime/events?window=24h

实时信号按已完成分析的政策、权威媒体和即时财经材料聚合，使用当前活动板块目录。 channel 可选 policy、media、market_attention 或 all。其中 market_attention 表示财联社等即时财经材料形成的市场关注，不参与政策权重。

响应同时提供三个渠道分数、综合关注强度、前一个等长窗口强度、变化量和材料依据。 窗口独立于每日完整版本，新版本发布不会删除仍处于窗口内的实时材料。连续读取材料应 使用服务返回的不透明游标。

三类信号排名

同一接口通过 view 分别查询：

GET /api/gendangzou/sector-heat?view=policy
GET /api/gendangzou/sector-heat?view=market_attention
GET /api/gendangzou/sector-heat?view=market_trading

政策热度 policy

衡量国家战略和产业布局相关的权威政策贡献。分数随时间衰减，反复提及可以叠加，每项 贡献都能追溯到材料和观点。

市场关注 market_attention

衡量国家级通讯社、高置信财经媒体和经过过滤的财经快讯对产业主题的关注变化。它可以 发现政策文件之外的新主题，但不等于政策权重。

资金确认 market_trading

基于动态公司映射和实际交易数据聚合，衡量板块内部交易表现的确认程度。公司是聚合 输入，输出结论仍然是板块。

三类信号量纲和证据来源不同，必须分别展示。同步和分歧都属于结果，不能用未经定义的 加总分掩盖。

板块异动与关联

GET /api/gendangzou/sector-dynamics

该接口提供：

• 相对同层板块的强弱。
• 相对全市场中位数的超额表现。
• 上涨广度和板块内部确认。
• 同日共振、分歧、层级分歧和结构重叠。

共同成分公司造成的机械同步会标记为 structural_overlap。历史样本未达到要求时， 接口不会输出领先滞后或因果判断。

资金贡献明细

GET /api/gendangzou/sectors/{sector_id}/trading-contributors

该接口解释哪些有效映射公司进入了板块资金聚合及其权重。资金贡献公司数可以少于板块 关联公司数，因为观察中关系、停牌、缺失行情或不满足聚合条件的公司不会进入当次计算。

历史轨迹

GET /api/gendangzou/sectors/{sector_id}/heat-series?view=policy

分别使用 policy、market_attention 和 market_trading 查询同一板块的历史轨迹。 该接口直接按日期范围工作，不要求先调用快照列表。

休市与资金日期

资金结果必须同时读取 market_trade_date 和 market_status：

market_status	解释
fresh	有新的收盘交易数据
carried_forward	休市，沿用最近交易日数据
reaggregated	沿用最近交易数据，按当前板块映射重新聚合
unavailable	当前版本没有可用资金运行

休市沿用不能表述为自然日发生了新的资金变化。