---
title: "获取公司研究档案概览"
description: "默认读取公司的最新已发布研究版本及五类事实覆盖；研究版本独立于日报快照。"
pageClass: gendangzou-doc
---

# 获取公司研究档案概览

`company.research.detail`

默认读取公司的最新已发布研究版本及五类事实覆盖；研究版本独立于日报快照。

## 调用契约

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

受控意图：`get_company_research`、`inspect_company_facts`

## 请求参数

| 参数 | 位置 | 类型 | 必填 | 约束与默认值 |
| --- | --- | --- | --- | --- |
| `stock_code` | path | string | 是 | 匹配 `^[0-9]{6}$` |
| `research_as_of` | query | string | 否 | Return the latest company research version on or before this date；格式 `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>/research"
```

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

## 响应

| 字段 | 类型 | 必有 | 含义 |
| --- | --- | --- | --- |
| `stock_code` | `string` | 是 | 保留前导零的六位 A 股代码。 |
| `available` | `boolean` | 是 | 所选日期是否存在通过质量门控并正式发布的研究档案。 |
| `profile` | `CompanyResearchProfile / null` | 否 | 公司研究档案概况；没有已发布版本时为空。 |

### `CompanyResearchProfile`

| 字段 | 类型 | 必有 | 含义 |
| --- | --- | --- | --- |
| `version_id` | `string` | 是 | - |
| `version_number` | `integer` | 否 | - |
| `published_at` | `string` | 是 | 完整数据版本的发布时间。 |
| `previous_version_id` | `string` | 否 | - |
| `change_summary` | `CompanyResearchChangeSummary` | 否 | - |
| `stock_code` | `string` | 是 | 保留前导零的六位 A 股代码。 |
| `company_name` | `string` | 是 | 交易所名册记录的公司全称。 |
| `research_as_of` | `string` | 是 | 公司研究版本覆盖材料的截止日期。 |
| `completeness_status` | `string` | 否 | 研究版本是否通过完整性质量门控。 |
| `fact_count` | `integer` | 否 | 归并材料包含的公司业务事实数量。 |
| `relationship_count` | `integer` | 否 | 公司研究档案中的结构化关系记录数量。 |
| `evidence_count` | `integer` | 否 | 支撑当前结果的可溯源证据数量。 |
| `material_count` | `integer` | 否 | 支撑当前结果的独立原始材料数量。 |
| `categories` | `array<CompanyResearchCategorySummary>` | 否 | 五类公司研究事实的覆盖统计。 |

### `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>` | 否 | - |

### `CompanyResearchCategorySummary`

| 字段 | 类型 | 必有 | 含义 |
| --- | --- | --- | --- |
| `category` | `string` | 是 | 对象或关系分类。 |
| `label` | `string` | 是 | 面向展示的规范中文名称。 |
| `domains` | `array<string>` | 否 | 当前分类实际覆盖的结构化事实域。 |
| `fact_count` | `integer` | 否 | 归并材料包含的公司业务事实数量。 |
| `relationship_count` | `integer` | 否 | 公司研究档案中的结构化关系记录数量。 |
| `evidence_count` | `integer` | 否 | 支撑当前结果的可溯源证据数量。 |
| `material_count` | `integer` | 否 | 支撑当前结果的独立原始材料数量。 |
| `latest_fact_date` | `string` | 否 | 该分类中最近一项事实的日期。 |
| `average_confidence` | `number` | 否 | 该分类中事实置信度的加权平均值。 |

## 调用要点

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

## 关联能力

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

## 机器可读契约

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