---
title: "查询板块历史热度序列"
description: "按政策、市场关注或资金确认维度查询板块历史轨迹。"
pageClass: gendangzou-doc
---

# 查询板块历史热度序列

`sector.heat_series`

按政策、市场关注或资金确认维度查询板块历史轨迹。

## 调用契约

| 项目 | 值 |
| --- | --- |
| Method | `GET` |
| Path | `/api/gendangzou/sectors/{sector_id}/heat-series` |
| 业务域 | `sector` |
| 数据更新 | 随完整数据版本发布 |

受控意图：`get_sector_trajectory`、`compare_sector_history`

## 请求参数

| 参数 | 位置 | 类型 | 必填 | 约束与默认值 |
| --- | --- | --- | --- | --- |
| `sector_id` | path | string | 是 | 最短 3 字符；最长 128 字符 |
| `view` | query | string | 否 | 默认 `policy`；可选 `policy`、`market_attention`、`market_trading` |
| `start` | query | string | 否 | 格式 `date` |
| `end` | query | string | 否 | 格式 `date` |
| `limit` | query | integer | 否 | 默认 `90`；最小 1；最大 366 |

## 最小调用

```bash
curl --fail --silent --show-error \
  -H "Authorization: Bearer $MOBIUSQUANT_TOKEN" \
  "https://api.mobiusquant.ai/api/gendangzou/sectors/<sector_id>/heat-series"
```

将路径中的 `<...>` 替换为实际资源 ID。

## 响应

| 字段 | 类型 | 必有 | 含义 |
| --- | --- | --- | --- |
| `sector_id` | `string` | 是 | 板块稳定标识。 |
| `view` | `string` | 是 | 信号维度：policy、market_attention 或 market_trading。 |
| `items` | `array<HeatSeriesPoint>` | 是 | 当前查询返回的结果列表。 |

### `HeatSeriesPoint`

| 字段 | 类型 | 必有 | 含义 |
| --- | --- | --- | --- |
| `snapshot_id` | `string` | 是 | 完整数据版本标识。 |
| `as_of` | `string` | 是 | 该数据版本对应的业务日期。 |
| `effective_date` | `string` | 是 | 该序列点实际生效的日期。 |
| `taxonomy_version` | `string` | 是 | - |
| `sector_name` | `string` | 是 | 板块名称。 |
| `layer` | `string` | 是 | 板块层级。 |
| `heat_level` | `number` | 是 | 当前维度的板块热度水平。 |
| `cross_section_percentile` | `number` | 是 | - |
| `heat_momentum` | `number` | 是 | 相对上一可比版本的热度变化。 |
| `contribution_count` | `integer` | 是 | 进入当前热度计算的贡献项数量。 |
| `evidence_count` | `integer` | 是 | 支撑当前结果的可溯源证据数量。 |
| `direction_score` | `number` | 否 | 方向强度，正值、负值和零分别表示正向、负向和中性。 |
| `direction_momentum` | `number` | 否 | - |
| `direction_coverage` | `number` | 否 | - |
| `disagreement_score` | `number` | 否 | - |

## 调用要点

- 需要解释结论时，再调用关联证据能力。

## 关联能力

- [`signal.heat.rank`](/zh/gendangzou/capabilities/signal.heat.rank)
- [`sector.detail`](/zh/gendangzou/capabilities/sector.detail)

## 机器可读契约

- [完整能力清单](/zh/gendangzou/agent-manifest.json)
- [在线能力详情](https://api.mobiusquant.ai/api/gendangzou/capabilities/sector.heat_series)