---
title: 板块与三类信号
description: 自有 A 股板块目录、政策热度、市场关注、资金确认、板块异动和历史轨迹。
pageClass: gendangzou-doc
---

# 板块与三类信号

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

## 板块目录

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

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

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

## 连续实时信号

```http
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` 分别查询：

```http
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`

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

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

## 板块异动与关联

```http
GET /api/gendangzou/sector-dynamics
```

该接口提供：

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

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

## 资金贡献明细

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

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

## 历史轨迹

```http
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` | 当前版本没有可用资金运行 |

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