---
title: "查询板块信号排名"
description: "分别查询政策热度、市场关注度或资金确认度，不合并三类口径。"
pageClass: gendangzou-doc
---

# 查询板块信号排名

`signal.heat.rank`

分别查询政策热度、市场关注度或资金确认度，不合并三类口径。

## 调用契约

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

受控意图：`rank_sectors`、`compare_signals`、`find_hot_sectors`

## 请求参数

| 参数 | 位置 | 类型 | 必填 | 约束与默认值 |
| --- | --- | --- | --- | --- |
| `view` | query | string | 否 | 默认 `policy`；可选 `policy`、`market_attention`、`market_trading` |
| `layer` | query | string | 否 | 可选 `own_l1`、`own_l2`、`dynamic` |
| `status` | query | string | 否 | 最短 2 字符；最长 32 字符 |
| `page` | query | integer | 否 | 从 1 开始的页码；默认 `1`；最小 1 |
| `page_size` | query | integer | 否 | 默认 `50`；最小 1；最大 100 |
| `snapshot_id` | query | string | 否 | 最短 8 字符；最长 128 字符 |
| `as_of` | query | string | 否 | 返回此日期或此前最近的完整快照；格式 `date` |
| `detail` | query | string | 否 | full 保留完整 Web 响应；compact 返回供 Agent 使用的稳定快照引用；默认 `full`；可选 `full`、`compact` |
| `include` | query | string | 否 | 逗号分隔的精简版本扩展：sector_dynamics、coverage；最长 80 字符 |

## 最小调用

```bash
curl --fail --silent --show-error \
  -H "Authorization: Bearer $MOBIUSQUANT_TOKEN" \
  "https://api.mobiusquant.ai/api/gendangzou/sector-heat?page_size=10&detail=compact"
```



## 响应

| 字段 | 类型 | 必有 | 含义 |
| --- | --- | --- | --- |
| `snapshot` | `SnapshotContext / SnapshotReference` | 是 | 本次查询实际使用的数据版本。 |
| `view` | `string` | 是 | 信号维度：policy、market_attention 或 market_trading。 |
| `items` | `array<HeatItem>` | 是 | 当前查询返回的结果列表。 |
| `pagination` | `Pagination` | 是 | 分页位置、总数和总页数。 |

### `HeatItem`

| 字段 | 类型 | 必有 | 含义 |
| --- | --- | --- | --- |
| `sector_id` | `string` | 是 | 板块稳定标识。 |
| `sector_name` | `string` | 是 | 板块名称。 |
| `layer` | `string` | 是 | 板块层级。 |
| `status` | `string` | 是 | 对象或关系的当前状态。 |
| `view` | `string` | 是 | 信号维度：policy、market_attention 或 market_trading。 |
| `heat_level` | `number` | 是 | 当前维度的板块热度水平。 |
| `heat_momentum` | `number` | 是 | 相对上一可比版本的热度变化。 |
| `contribution_count` | `integer` | 是 | 进入当前热度计算的贡献项数量。 |
| `evidence_count` | `integer` | 是 | 支撑当前结果的可溯源证据数量。 |
| `by_signal` | `object` | 否 | 按底层信号类型拆分的贡献。 |

## 调用要点

- Agent 建议使用 `detail=compact` 控制上下文体积。
- 分页从 `page_size=10` 开始，确认需要后再继续翻页。
- 需要解释结论时，再调用关联证据能力。

## 关联能力

- [`signal.dynamics.list`](/zh/gendangzou/capabilities/signal.dynamics.list)
- [`evidence.sector.list`](/zh/gendangzou/capabilities/evidence.sector.list)
- [`snapshot.latest`](/zh/gendangzou/capabilities/snapshot.latest)

## 机器可读契约

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