---
title: "查询公司研究变化时间轴"
description: "按公司列出已发布研究版本及事实、关系、材料和缺口的变化摘要。"
pageClass: gendangzou-doc
---

# 查询公司研究变化时间轴

`company.research.versions.list`

按公司列出已发布研究版本及事实、关系、材料和缺口的变化摘要。

## 调用契约

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

受控意图：`list_company_research_versions`、`trace_company_research_changes`

## 请求参数

| 参数 | 位置 | 类型 | 必填 | 约束与默认值 |
| --- | --- | --- | --- | --- |
| `stock_code` | path | string | 是 | 匹配 `^[0-9]{6}$` |
| `page` | query | integer | 否 | 从 1 开始的页码；默认 `1`；最小 1 |
| `page_size` | query | integer | 否 | 默认 `20`；最小 1；最大 100 |

## 最小调用

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

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

## 响应

| 字段 | 类型 | 必有 | 含义 |
| --- | --- | --- | --- |
| `stock_code` | `string` | 是 | 保留前导零的六位 A 股代码。 |
| `items` | `array<CompanyResearchVersion>` | 是 | 当前查询返回的结果列表。 |
| `pagination` | `Pagination` | 是 | 分页位置、总数和总页数。 |

### `CompanyResearchVersion`

| 字段 | 类型 | 必有 | 含义 |
| --- | --- | --- | --- |
| `version_id` | `string` | 是 | - |
| `version_number` | `integer` | 是 | - |
| `research_as_of` | `string` | 是 | 公司研究版本覆盖材料的截止日期。 |
| `published_at` | `string` | 是 | 完整数据版本的发布时间。 |
| `previous_version_id` | `string` | 否 | - |
| `fact_count` | `integer` | 否 | 归并材料包含的公司业务事实数量。 |
| `relationship_count` | `integer` | 否 | 公司研究档案中的结构化关系记录数量。 |
| `gap_count` | `integer` | 否 | - |
| `change_summary` | `CompanyResearchChangeSummary` | 否 | - |

### `CompanyResearchChangeSummary`

| 字段 | 类型 | 必有 | 含义 |
| --- | --- | --- | --- |
| `initial_version` | `boolean` | 否 | - |
| `facts_added` | `integer` | 否 | - |
| `facts_removed` | `integer` | 否 | - |
| `relationships_added` | `integer` | 否 | - |
| `relationships_removed` | `integer` | 否 | - |
| `materials_added` | `integer` | 否 | - |
| `materials_removed` | `integer` | 否 | - |
| `gaps_opened` | `integer` | 否 | - |
| `gaps_resolved` | `integer` | 否 | - |
| `changed_domains` | `array<string>` | 否 | - |

## 调用要点

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

## 关联能力

- [`company.research.detail`](/zh/gendangzou/capabilities/company.research.detail)
- [`company.research.facts.list`](/zh/gendangzou/capabilities/company.research.facts.list)

## 机器可读契约

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