---
title: "查询国资变动时间轴"
description: "列出国资进入、增持、减持、退出及控制关系变化，并区分拟议、批准、完成和终止。"
pageClass: gendangzou-doc
---

# 查询国资变动时间轴

`company.state_capital.events.list`

列出国资进入、增持、减持、退出及控制关系变化，并区分拟议、批准、完成和终止。

## 调用契约

| 项目 | 值 |
| --- | --- |
| Method | `GET` |
| Path | `/api/gendangzou/companies/{stock_code}/state-capital/events` |
| 业务域 | `company` |
| 数据更新 | 随质量门控后的公司研究版本发布 |

受控意图：`trace_state_capital_changes`、`inspect_state_capital_entry_exit`

## 请求参数

| 参数 | 位置 | 类型 | 必填 | 约束与默认值 |
| --- | --- | --- | --- | --- |
| `stock_code` | path | string | 是 | 匹配 `^[0-9]{6}$` |
| `start` | query | string | 否 | 格式 `date` |
| `end` | query | string | 否 | 格式 `date` |
| `lifecycle_status` | query | string | 否 | 可选 `proposed`、`approved`、`completed`、`terminated` |
| `page` | query | integer | 否 | 从 1 开始的页码；默认 `1`；最小 1 |
| `page_size` | query | integer | 否 | 默认 `20`；最小 1；最大 100 |
| `research_as_of` | query | string | 否 | 格式 `date` |
| `version_id` | query | string | 否 | 最短 8 字符；最长 128 字符 |

## 最小调用

```bash
curl --fail --silent --show-error \
  -H "Authorization: Bearer $MOBIUSQUANT_TOKEN" \
  "https://api.mobiusquant.ai/api/gendangzou/companies/<stock_code>/state-capital/events?page_size=10"
```

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

## 响应

| 字段 | 类型 | 必有 | 含义 |
| --- | --- | --- | --- |
| `stock_code` | `string` | 是 | 保留前导零的六位 A 股代码。 |
| `version_id` | `string` | 是 | - |
| `research_as_of` | `string` | 是 | 公司研究版本覆盖材料的截止日期。 |
| `items` | `array<CompanyStateCapitalEvent>` | 是 | 当前查询返回的结果列表。 |
| `pagination` | `Pagination` | 是 | 分页位置、总数和总页数。 |

### `CompanyStateCapitalEvent`

| 字段 | 类型 | 必有 | 含义 |
| --- | --- | --- | --- |
| `event_id` | `string` | 是 | - |
| `event_type` | `string` | 是 | - |
| `title` | `string` | 是 | 原始材料标题。 |
| `actor_node_id` | `string` | 否 | - |
| `actor_name` | `string` | 否 | - |
| `target_node_id` | `string` | 否 | - |
| `target_name` | `string` | 否 | - |
| `event_date` | `string` | 是 | 事实对应的发生日期。 |
| `announced_at` | `string` | 否 | - |
| `effective_at` | `string` | 否 | - |
| `lifecycle_status` | `string` | 是 | 当前对象的生命周期状态。 |
| `before_percentage` | `number / null` | 否 | - |
| `after_percentage` | `number / null` | 否 | - |
| `change_percentage` | `number / null` | 否 | - |
| `control_impact` | `string` | 否 | - |
| `summary` | `string` | 是 | 当前查询的聚合统计。 |
| `confidence` | `number` | 否 | 结果置信度；不能与关系分或热度分互换。 |
| `evidence_count` | `integer` | 否 | 支撑当前结果的可溯源证据数量。 |
| `fact_ids` | `array<string>` | 否 | - |

## 调用要点

- 分页从 `page_size=10` 开始，确认需要后再继续翻页。
- 需要解释结论时，再调用关联证据能力。

## 关联能力

- [`company.state_capital.detail`](/zh/gendangzou/capabilities/company.state_capital.detail)
- [`company.state_capital.event_evidence.list`](/zh/gendangzou/capabilities/company.state_capital.event_evidence.list)

## 机器可读契约

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