---
title: "查询实时材料与板块总览"
description: "按独立滚动时间窗口查询政策、权威媒体和即时市场关注事件流，同时返回板块聚合与可溯源材料；日报快照不会重置该窗口。"
pageClass: gendangzou-doc
---

# 查询实时材料与板块总览

`signal.realtime.overview`

按独立滚动时间窗口查询政策、权威媒体和即时市场关注事件流，同时返回板块聚合与可溯源材料；日报快照不会重置该窗口。

## 调用契约

| 项目 | 值 |
| --- | --- |
| Method | `GET` |
| Path | `/api/gendangzou/realtime` |
| 业务域 | `signal` |
| 数据更新 | 每 5 分钟发现新增材料；正文与分析完成后发布 |

受控意图：`find_realtime_sector_signals`、`monitor_intraday_sector_attention`、`monitor_realtime_market_attention`、`trace_realtime_materials`

## 请求参数

| 参数 | 位置 | 类型 | 必填 | 约束与默认值 |
| --- | --- | --- | --- | --- |
| `window` | query | string | 否 | 默认 `24h`；可选 `1h`、`6h`、`24h`、`3d` |
| `channel` | query | string | 否 | 默认 `all`；可选 `all`、`policy`、`media`、`market_attention` |
| `sector_limit` | query | integer | 否 | 默认 `20`；最小 1；最大 100 |
| `material_limit` | query | integer | 否 | 默认 `30`；最小 1；最大 100 |

## 最小调用

```bash
curl --fail --silent --show-error \
  -H "Authorization: Bearer $MOBIUSQUANT_TOKEN" \
  "https://api.mobiusquant.ai/api/gendangzou/realtime"
```



## 响应

| 字段 | 类型 | 必有 | 含义 |
| --- | --- | --- | --- |
| `schema_version` | `string` | 否 | - |
| `business_date` | `string` | 是 | 本次查询使用的北京时间业务日期。 |
| `generated_at` | `string` | 是 | - |
| `window` | `RealtimeWindow` | 是 | 独立于日报的滚动时间窗口及前一个等长比较窗口。 |
| `catalog` | `RealtimeCatalog` | 是 | 实时聚合使用的当前活动板块目录。 |
| `summary` | `RealtimeSummary` | 是 | 当前查询的聚合统计。 |
| `sectors` | `array<RealtimeSectorDelta>` | 是 | 当前对象关联的板块摘要或映射结果。 |
| `materials` | `array<RealtimeMaterialItem>` | 是 | - |
| `material_pagination` | `RealtimeCursorPagination` | 是 | 实时总览中材料流的游标分页位置。 |

### `RealtimeWindow`

| 字段 | 类型 | 必有 | 含义 |
| --- | --- | --- | --- |
| `kind` | `string` | 否 | - |
| `duration` | `string` | 是 | 当前滚动窗口长度。 |
| `timezone` | `string` | 否 | - |
| `start` | `string` | 是 | 当前窗口起点，包含该时刻。 |
| `end` | `string` | 是 | 当前窗口终点，不包含该时刻。 |
| `previous_start` | `string` | 是 | 前一个等长窗口起点。 |
| `previous_end` | `string` | 是 | 前一个等长窗口终点。 |

### `RealtimeCatalog`

| 字段 | 类型 | 必有 | 含义 |
| --- | --- | --- | --- |
| `release_id` | `string` | 是 | - |
| `namespace` | `string` | 是 | - |
| `version` | `string` | 是 | - |
| `as_of` | `string` | 是 | 该数据版本对应的业务日期。 |
| `status` | `string` | 是 | 对象或关系的当前状态。 |
| `activated_at` | `string` | 是 | - |
| `sector_count` | `integer` | 是 | 当前活动板块目录节点数。 |

### `RealtimeSummary`

| 字段 | 类型 | 必有 | 含义 |
| --- | --- | --- | --- |
| `material_count` | `integer` | 是 | - |
| `policy_material_count` | `integer` | 是 | - |
| `media_material_count` | `integer` | 是 | - |
| `market_attention_material_count` | `integer` | 是 | - |
| `sector_count` | `integer` | 是 | 当前结果关联的板块数量。 |
| `new_signal_sector_count` | `integer` | 是 | - |
| `multi_source_sector_count` | `integer` | 是 | - |
| `pressure_sector_count` | `integer` | 是 | - |

### `RealtimeSectorDelta`

| 字段 | 类型 | 必有 | 含义 |
| --- | --- | --- | --- |
| `sector_id` | `string` | 是 | 板块稳定标识。 |
| `sector_name` | `string` | 是 | 板块名称。 |
| `layer` | `string` | 是 | 板块层级。 |
| `signals` | `array<string>` | 否 | - |
| `attention_score` | `number` | 是 | 当前滚动窗口内政策、权威媒体与即时市场关注的综合强度。 |
| `policy_score` | `number` | 是 | 当前滚动窗口内的政策材料强度。 |
| `media_score` | `number` | 是 | 当前滚动窗口内的权威媒体材料强度。 |
| `market_attention_score` | `number` | 是 | 当前滚动窗口内即时财经材料形成的市场关注强度。 |
| `previous_attention_score` | `number` | 否 | 前一个等长窗口的综合关注强度。 |
| `previous_policy_score` | `number` | 否 | 前一个等长窗口的政策材料强度。 |
| `previous_media_score` | `number` | 否 | 前一个等长窗口的媒体材料强度。 |
| `previous_market_attention_score` | `number` | 否 | 前一个等长窗口的即时市场关注强度。 |
| `attention_change` | `number` | 否 | 当前综合关注强度相对前一个等长窗口的变化。 |
| `policy_change` | `number` | 否 | 当前政策强度相对前一个等长窗口的变化。 |
| `media_change` | `number` | 否 | 当前媒体强度相对前一个等长窗口的变化。 |
| `market_attention_change` | `number` | 否 | 当前即时市场关注强度相对前一个等长窗口的变化。 |
| `previous_material_count` | `integer` | 否 | - |
| `direction_balance` | `number / null` | 否 | - |
| `direction_coverage` | `number` | 否 | - |
| `material_count` | `integer` | 是 | - |
| `policy_material_count` | `integer` | 是 | - |
| `media_material_count` | `integer` | 是 | - |
| `market_attention_material_count` | `integer` | 是 | - |
| `source_count` | `integer` | 是 | - |
| `positive_material_count` | `integer` | 是 | - |
| `negative_material_count` | `integer` | 是 | - |
| `neutral_material_count` | `integer` | 是 | - |
| `latest_signal_at` | `string` | 是 | - |
| `material_ids` | `array<string>` | 否 | 归并到当前展示项的全部材料标识。 |
| `references` | `array<RealtimeMaterialReference>` | 否 | - |

### `RealtimeMaterialReference`

| 字段 | 类型 | 必有 | 含义 |
| --- | --- | --- | --- |
| `material_id` | `string` | 是 | 归并后材料的主标识。 |
| `channel` | `string` | 是 | - |
| `source_id` | `string` | 是 | 材料来源标识。 |
| `source_name` | `string` | 是 | 材料来源名称。 |
| `title` | `string` | 是 | 原始材料标题。 |
| `url` | `string` | 是 | 原始材料 URL。 |
| `signal_ready_at` | `string` | 是 | - |
| `evidence_id` | `string` | 否 | 可溯源证据标识。 |
| `viewpoint` | `string` | 否 | 系统从材料中抽取的产业观点。 |
| `rationale` | `string` | 否 | 当前判断或关系的依据。 |
| `impact_direction` | `string` | 否 | 材料对板块的正向、负向、中性或未知方向。 |
| `direction_score` | `number` | 否 | 方向强度，正值、负值和零分别表示正向、负向和中性。 |

### `RealtimeMaterialItem`

| 字段 | 类型 | 必有 | 含义 |
| --- | --- | --- | --- |
| `material_id` | `string` | 是 | 归并后材料的主标识。 |
| `material_ids` | `array<string>` | 否 | 归并到当前展示项的全部材料标识。 |
| `duplicate_count` | `integer` | 否 | 归并到当前展示项的重复材料数量。 |
| `source_id` | `string` | 是 | 材料来源标识。 |
| `source_name` | `string` | 是 | 材料来源名称。 |
| `authority` | `string` | 是 | 来源权威属性。 |
| `source_tier` | `string` | 是 | 材料来源的权重层级。 |
| `sources` | `array<PolicyMaterialSource>` | 否 | 归并材料涉及的全部来源。 |
| `title` | `string` | 是 | 原始材料标题。 |
| `url` | `string` | 是 | 原始材料 URL。 |
| `material_date` | `string` | 是 | 材料发布日期。 |
| `doc_no` | `string` | 否 | 政策文号；来源没有文号时为空。 |
| `first_seen_at` | `string` | 是 | 系统首次发现材料的时间。 |
| `signal_ready_at` | `string` | 否 | 正文、观点分析和当前板块目录映射全部完成的时间。 |
| `lifecycle_stage` | `string` | 否 | 政策材料在征求意见、正式发布等生命周期中的阶段。 |
| `lifecycle_status` | `string` | 否 | 当前对象的生命周期状态。 |
| `evidence_count` | `integer` | 否 | 支撑当前结果的可溯源证据数量。 |
| `sector_count` | `integer` | 否 | 当前结果关联的板块数量。 |
| `results` | `array<PolicyMaterialResult>` | 否 | 从材料中抽取的产业观点和板块映射。 |
| `channel` | `string` | 是 | - |

### `PolicyMaterialSource`

| 字段 | 类型 | 必有 | 含义 |
| --- | --- | --- | --- |
| `source_id` | `string` | 是 | 材料来源标识。 |
| `name` | `string` | 是 | 对象名称。 |
| `authority` | `string` | 是 | 来源权威属性。 |
| `tier` | `string` | 是 | - |
| `weight` | `number` | 否 | - |

### `PolicyMaterialResult`

| 字段 | 类型 | 必有 | 含义 |
| --- | --- | --- | --- |
| `evidence_id` | `string` | 是 | 可溯源证据标识。 |
| `viewpoint` | `string` | 是 | 系统从材料中抽取的产业观点。 |
| `quote` | `string` | 否 | 支撑观点或事实的原文摘录。 |
| `signal_type` | `string` | 是 | 政策、市场关注或其他受控信号类型。 |
| `confidence` | `string / number / null` | 否 | 结果置信度；不能与关系分或热度分互换。 |
| `impact_direction` | `string` | 否 | 材料对板块的正向、负向、中性或未知方向。 |
| `direction_score` | `number` | 否 | 方向强度，正值、负值和零分别表示正向、负向和中性。 |
| `direction_confidence` | `string` | 否 | 方向判断的置信等级。 |
| `impact_horizon` | `string` | 否 | 材料影响的预期时间范围。 |
| `direction_rationale` | `string` | 否 | 方向判断依据。 |
| `sectors` | `array<PolicyMaterialSector>` | 否 | 当前对象关联的板块摘要或映射结果。 |

### `PolicyMaterialSector`

| 字段 | 类型 | 必有 | 含义 |
| --- | --- | --- | --- |
| `sector_id` | `string` | 是 | 板块稳定标识。 |
| `sector_name` | `string` | 是 | 板块名称。 |
| `layer` | `string` | 否 | 板块层级。 |
| `current_catalog_match` | `boolean` | 否 | 该板块是否存在于当前目录版本。 |
| `confidence` | `string / number / null` | 否 | 结果置信度；不能与关系分或热度分互换。 |
| `rationale` | `string` | 否 | 当前判断或关系的依据。 |
| `impact_direction` | `string` | 否 | 材料对板块的正向、负向、中性或未知方向。 |
| `direction_score` | `number` | 否 | 方向强度，正值、负值和零分别表示正向、负向和中性。 |
| `direction_confidence` | `string` | 否 | 方向判断的置信等级。 |
| `direction_rationale` | `string` | 否 | 方向判断依据。 |

### `RealtimeCursorPagination`

| 字段 | 类型 | 必有 | 含义 |
| --- | --- | --- | --- |
| `limit` | `integer` | 是 | - |
| `has_more` | `boolean` | 是 | 是否仍有更早的实时材料。 |
| `next_cursor` | `string / null` | 否 | 下一页不透明游标；调用方必须原样传回。 |

## 调用要点

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

## 关联能力

- [`material.policy.list`](/zh/gendangzou/capabilities/material.policy.list)
- [`material.media.list`](/zh/gendangzou/capabilities/material.media.list)
- [`sector.detail`](/zh/gendangzou/capabilities/sector.detail)

## 机器可读契约

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