查询公司研究事实
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开始，确认需要后再继续翻页。 - 需要解释结论时，再调用关联证据能力。