获取公司板块概况
company.detail
返回公司市场标识及其当前有效、观察中和候选板块关系。
调用契约
| 项目 | 值 |
|---|---|
| Method | GET |
| Path | /api/gendangzou/companies/{stock_code} |
| 业务域 | company |
| 数据更新 | 随完整数据版本发布 |
受控意图：get_company_detail、inspect_company_mapping
请求参数
| 参数 | 位置 | 类型 | 必填 | 约束与默认值 |
|---|---|---|---|---|
stock_code | path | string | 是 | 匹配 ^[0-9]{6}$ |
snapshot_id | query | string | 否 | 最短 8 字符；最长 128 字符 |
as_of | query | string | 否 | 返回此日期或此前最近的完整快照；格式 date |
detail | query | string | 否 | full 保留完整 Web 响应；compact 返回供 Agent 使用的稳定快照引用；默认 full；可选 full、compact |
include | query | string | 否 | 逗号分隔的精简版本扩展：sector_dynamics、coverage；最长 80 字符 |
最小调用
bash
curl --fail --silent --show-error \
-H "Authorization: Bearer $MOBIUSQUANT_TOKEN" \
"https://api.mobiusquant.ai/api/gendangzou/companies/<stock_code>?detail=compact"将路径中的 <...> 替换为实际资源 ID。
响应
| 字段 | 类型 | 必有 | 含义 |
|---|---|---|---|
snapshot | SnapshotContext / SnapshotReference | 是 | 本次查询实际使用的数据版本。 |
stock_code | string | 是 | 保留前导零的六位 A 股代码。 |
stock_name | string | 是 | 上市公司简称。 |
company_name | string | 否 | 交易所名册记录的公司全称。 |
market | string | 是 | 市场标识。 |
exchange | string | 是 | 上市交易所。 |
board | string | 是 | A 股上市板标识。 |
lifecycle_status | string | 否 | 当前对象的生命周期状态。 |
listing_date | string / null | 否 | - |
market_data_status | string | 否 | - |
sectors | array<CompanySectorRelation> | 是 | 当前对象关联的板块摘要或映射结果。 |
CompanySectorRelation
| 字段 | 类型 | 必有 | 含义 |
|---|---|---|---|
relation_id | string | 是 | 公司与板块关系的稳定标识，用于继续查询证据。 |
stock_code | string | 是 | 保留前导零的六位 A 股代码。 |
stock_name | string | 是 | 上市公司简称。 |
market | string | 否 | 市场标识。 |
exchange | string | 是 | 上市交易所。 |
board | string | 是 | A 股上市板标识。 |
sector_id | string | 是 | 板块稳定标识。 |
sector_name | string | 是 | 板块名称。 |
sector_layer | string | 是 | 关系对应板块的层级。 |
relation_type | string | 是 | 公司与板块的业务关系或市场关系。 |
status | string | 是 | 对象或关系的当前状态。 |
score | number | 是 | 公司业务事实与板块定义的关系强度。 |
confidence | number | 是 | 结果置信度；不能与关系分或热度分互换。 |
first_seen | string / null | 否 | 关系首次出现日期。 |
last_confirmed | string / null | 否 | - |
valid_from | string / null | 否 | 关系有效期起始日期。 |
valid_to | string / null | 否 | 关系有效期结束日期；仍有效时为空。 |
evidence_count | integer | 否 | 支撑当前结果的可溯源证据数量。 |
mapping_explanation | MappingExplanation / null | 否 | 公司业务事实、映射逻辑、边界和结论。 |
lifecycle_status | string | 否 | 当前对象的生命周期状态。 |
listing_date | string / null | 否 | - |
market_data_status | string | 否 | - |
MappingExplanation
| 字段 | 类型 | 必有 | 含义 |
|---|---|---|---|
fact | string | 否 | - |
logic | string | 否 | - |
participation_summary | string | 否 | 公司在板块价值链中的参与方式。 |
boundary_note | string | 否 | 关系成立范围及不能外推的边界。 |
conclusion | string | 否 | - |
participation_basis | string | 否 | 公司参与该产业环节的材料依据。 |
调用要点
- Agent 建议使用
detail=compact控制上下文体积。 - 需要解释结论时，再调用关联证据能力。