查询国资变动时间轴
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开始,确认需要后再继续翻页。 - 需要解释结论时,再调用关联证据能力。