---
title: "查询连续实时材料事件"
description: "按游标持续读取已完成分析的政策、权威媒体和即时财经材料，支持按板块、信源类型和滚动窗口过滤。"
pageClass: gendangzou-doc
---

# 查询连续实时材料事件

`signal.realtime.events`

按游标持续读取已完成分析的政策、权威媒体和即时财经材料，支持按板块、信源类型和滚动窗口过滤。

## 调用契约

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

受控意图：`stream_realtime_materials`、`trace_realtime_materials`、`monitor_new_policy_and_media`、`monitor_realtime_market_attention`

## 请求参数

| 参数 | 位置 | 类型 | 必填 | 约束与默认值 |
| --- | --- | --- | --- | --- |
| `window` | query | string | 否 | 默认 `24h`；可选 `1h`、`6h`、`24h`、`3d` |
| `channel` | query | string | 否 | 默认 `all`；可选 `all`、`policy`、`media`、`market_attention` |
| `sector_id` | query | string | 否 | 最短 3 字符；最长 128 字符 |
| `cursor` | query | string | 否 | 最短 8 字符；最长 512 字符 |
| `limit` | query | integer | 否 | 默认 `30`；最小 1；最大 100 |

## 最小调用

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



## 响应

| 字段 | 类型 | 必有 | 含义 |
| --- | --- | --- | --- |
| `schema_version` | `string` | 否 | - |
| `business_date` | `string` | 是 | 本次查询使用的北京时间业务日期。 |
| `generated_at` | `string` | 是 | - |
| `window` | `RealtimeWindow` | 是 | 独立于日报的滚动时间窗口及前一个等长比较窗口。 |
| `catalog` | `RealtimeCatalog` | 是 | 实时聚合使用的当前活动板块目录。 |
| `summary` | `RealtimeEventSummary` | 是 | 当前查询的聚合统计。 |
| `items` | `array<RealtimeMaterialItem>` | 是 | 当前查询返回的结果列表。 |
| `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` | 是 | 当前活动板块目录节点数。 |

### `RealtimeEventSummary`

| 字段 | 类型 | 必有 | 含义 |
| --- | --- | --- | --- |
| `material_count` | `integer` | 是 | - |
| `policy_material_count` | `integer` | 是 | - |
| `media_material_count` | `integer` | 是 | - |
| `market_attention_material_count` | `integer` | 是 | - |

### `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` | 否 | 下一页不透明游标；调用方必须原样传回。 |

## 调用要点

- 首次请求省略 `cursor`，从 `limit=10` 开始；仅在 `has_more=true` 时原样传回 `next_cursor`。
- 需要解释结论时，再调用关联证据能力。

## 关联能力

- [`signal.realtime.sectors`](/zh/gendangzou/capabilities/signal.realtime.sectors)
- [`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.events)