---
title: "查询公司研究事实"
description: "按研究分类或事实域分页读取结构化公司事实，保留日期与置信度。"
pageClass: gendangzou-doc
---

# 查询公司研究事实

`company.research.facts.list`

按研究分类或事实域分页读取结构化公司事实，保留日期与置信度。

## 调用契约

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

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

## 请求参数

| 参数 | 位置 | 类型 | 必填 | 约束与默认值 |
| --- | --- | --- | --- | --- |
| `stock_code` | path | string | 是 | 匹配 `^[0-9]{6}$` |
| `category` | query | string | 否 | 可选 `ownership_control`、`policy_support`、`financing_debt`、`capital_use`、`business_projects` |
| `domain` | query | string | 否 | 最短 3 字符；最长 80 字符 |
| `page` | query | integer | 否 | 从 1 开始的页码；默认 `1`；最小 1 |
| `page_size` | query | integer | 否 | 默认 `10`；最小 1；最大 100 |
| `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/facts?page_size=10"
```

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

## 响应

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

### `CompanyResearchFact`

| 字段 | 类型 | 必有 | 含义 |
| --- | --- | --- | --- |
| `fact_id` | `string` | 是 | 公司研究事实的稳定标识，用于继续查询原始依据。 |
| `category` | `string` | 是 | 对象或关系分类。 |
| `category_label` | `string` | 是 | - |
| `domain` | `string` | 是 | - |
| `domain_label` | `string` | 是 | - |
| `subject_name` | `string` | 是 | 公司研究事实中的主体名称。 |
| `predicate` | `string` | 是 | 结构化事实中的关系或行为。 |
| `object_name` | `string` | 否 | 公司研究事实中的客体名称。 |
| `value_text` | `string` | 否 | 事实中的主要文本值。 |
| `amount` | `number / null` | 否 | - |
| `currency` | `string` | 否 | 金额所使用的币种。 |
| `percentage` | `number / null` | 否 | 事实中的百分比数值。 |
| `unit` | `string` | 否 | 金额或数值的计量单位。 |
| `polarity` | `string` | 是 | 事实本身的正向、负向或中性属性。 |
| `statement_kind` | `string` | 是 | 已发生、历史、规划、拟议、预测或明确未发生等陈述性质。 |
| `event_date` | `string` | 否 | 事实对应的发生日期。 |
| `as_of_date` | `string` | 否 | 事实成立或统计口径对应的截止日期。 |
| `status` | `string` | 是 | 对象或关系的当前状态。 |
| `confidence` | `number` | 是 | 结果置信度；不能与关系分或热度分互换。 |
| `evidence_count` | `integer` | 否 | 支撑当前结果的可溯源证据数量。 |
| `material_count` | `integer` | 否 | 支撑当前结果的独立原始材料数量。 |

## 调用要点

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

## 关联能力

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

## 机器可读契约

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