获取公司研究档案概览
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 | 否 | 该分类中事实置信度的加权平均值。 |
调用要点
- 需要解释结论时,再调用关联证据能力。