审计 ETF、公司与板块贡献链
etf.relation.contributions
分页返回每个篮子成分、公司板块关系及其对调整暴露的完整贡献。
调用契约
| 项目 | 值 |
|---|---|
| Method | GET |
| Path | /api/gendangzou/etf-sector-relations/{relation_id}/contributions |
| 业务域 | etf |
| 数据更新 | 随交易所每日 PCF 和完整数据版本发布 |
受控意图：audit_etf_exposure、trace_etf_company_sector_contribution
请求参数
| 参数 | 位置 | 类型 | 必填 | 约束与默认值 |
|---|---|---|---|---|
relation_id | path | string | 是 | 最短 12 字符；最长 128 字符 |
page | query | integer | 否 | 从 1 开始的页码；默认 1；最小 1 |
page_size | query | integer | 否 | 默认 50；最小 1；最大 100 |
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/etf-sector-relations/<relation_id>/contributions?page_size=10&detail=compact"将路径中的 <...> 替换为实际资源 ID。
响应
| 字段 | 类型 | 必有 | 含义 |
|---|---|---|---|
snapshot | SnapshotContext / SnapshotReference | 是 | 本次查询实际使用的数据版本。 |
relation | EtfSectorRelation | 是 | 板块节点之间的关系类型。 |
items | array<EtfCompanySectorContribution> | 是 | 当前查询返回的结果列表。 |
pagination | Pagination | 是 | 分页位置、总数和总页数。 |
EtfSectorRelation
| 字段 | 类型 | 必有 | 含义 |
|---|---|---|---|
relation_id | string | 是 | ETF 与板块关系的稳定标识。 |
etf_key | string | 是 | 包含交易所前缀的稳定 ETF 标识。 |
fund_code | string | 是 | 保留前导零的六位基金代码。 |
etf_name | string | 是 | ETF 产品名称。 |
exchange | string | 是 | 上市交易所。 |
product_scope | string | 是 | ETF 产品范围：宽基或行业主题。 |
tracking_index_code | string | 否 | ETF 跟踪指数代码。 |
tracking_index_name | string | 否 | ETF 跟踪指数名称。 |
tracking_group_id | string | 否 | 按跟踪指数归并同类 ETF 的稳定组标识。 |
sector_id | string | 是 | 板块稳定标识。 |
sector_name | string | 是 | 板块名称。 |
sector_layer | string | 是 | 关系对应板块的层级。 |
mapping_type | string | 是 | ETF 板块关系的形成方式。 |
relation_scope | string | 否 | - |
source_sector_id | string | 否 | - |
source_sector_name | string | 否 | - |
source_sector_layer | string | 否 | - |
path | array<object> | 否 | - |
path_depth | integer | 否 | - |
path_confidence | number | 否 | - |
specificity_score | number | 否 | - |
semantic_score | number | 否 | - |
direct_child_exposure | number | 否 | - |
source_adjusted_exposure | number | 否 | - |
reference_only | boolean | 否 | - |
status | string | 是 | 对象或关系的当前状态。 |
exposure_ratio | number | 是 | ETF 篮子映射到板块的原始持仓权重。 |
adjusted_exposure | number | 是 | 叠加公司关系质量后的 ETF 板块暴露。 |
confidence | number | 是 | 结果置信度；不能与关系分或热度分互换。 |
holdings_coverage | number | 是 | ETF 篮子中具备公司板块映射的持仓覆盖率。 |
component_count | integer | 是 | 形成当前 ETF 板块关系的成分数量。 |
basket_date | string | 是 | 交易所官方 ETF 篮子日期。 |
basket_freshness_status | string | 否 | 本轮 ETF 篮子的核验或获取状态。 |
basket_age_days | integer | 否 | 篮子业务日期距快照业务日期的自然日数。 |
basket_checked_as_of | string | 否 | 最近一次向交易所产品目录核验篮子日期的日期。 |
catalog_verified | boolean | 否 | 本轮是否已经通过交易所产品目录核验。 |
content_changed | boolean / null | 否 | 本轮重新获取 PCF 后，篮子内容是否发生变化。 |
source_fetched_at | string | 否 | 当前使用的 PCF 原文实际获取时间。 |
official_pcf_url | string | 否 | 交易所官方申购赎回清单链接。 |
calculation | string | 否 | ETF 板块暴露的计算口径。 |
top_components | array<object> | 否 | 对当前 ETF 板块关系贡献较高的篮子成分。 |
EtfCompanySectorContribution
| 字段 | 类型 | 必有 | 含义 |
|---|---|---|---|
contribution_id | string | 是 | 单条 ETF、公司与板块贡献的稳定标识。 |
relation_id | string | 是 | ETF 与板块关系的稳定标识。 |
etf_key | string | 是 | 包含交易所前缀的稳定 ETF 标识。 |
basket_id | string | 是 | ETF 篮子的可追溯标识。 |
basket_date | string | 是 | 交易所官方 ETF 篮子日期。 |
stock_code | string | 是 | 保留前导零的六位 A 股代码。 |
stock_name | string | 否 | 上市公司简称。 |
sector_id | string | 是 | 板块稳定标识。 |
sector_name | string | 是 | 板块名称。 |
sector_layer | string | 是 | 关系对应板块的层级。 |
company_relation_id | string | 是 | 公司与板块关系的稳定标识。 |
company_relation_type | string | 是 | 公司关系类型：长期业务关系或短期市场关系。 |
company_relation_status | string | 是 | 公司板块关系在当前版本中的状态。 |
basket_weight | number | 是 | 该公司在 ETF 篮子中的原始权重。 |
company_relation_score | number | 是 | 公司业务事实与板块定义的关系强度。 |
company_relation_confidence | number | 是 | 公司板块关系的证据置信度。 |
relation_status_factor | number | 是 | 公司关系状态对应的调整因子。 |
relation_type_factor | number | 是 | 公司关系类型对应的调整因子。 |
adjusted_contribution | number | 是 | 该公司对 ETF 板块调整暴露的最终贡献。 |
调用要点
- Agent 建议使用
detail=compact控制上下文体积。 - 分页从
page_size=10开始，确认需要后再继续翻页。 - 需要解释结论时，再调用关联证据能力。