查询 ETF 板块暴露变化
etf.relation.changes
返回关系创建、状态跨档、显著暴露变化和失效事件，并说明变化来源。
调用契约
| 项目 | 值 |
|---|---|
| Method | GET |
| Path | /api/gendangzou/etf-sector-relations/{relation_id}/changes |
| 业务域 | etf |
| 数据更新 | 随交易所每日 PCF 和完整数据版本发布 |
受控意图：inspect_etf_exposure_changes、audit_etf_exposure
请求参数
| 参数 | 位置 | 类型 | 必填 | 约束与默认值 |
|---|---|---|---|---|
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>/changes?page_size=10&detail=compact"将路径中的 <...> 替换为实际资源 ID。
响应
| 字段 | 类型 | 必有 | 含义 |
|---|---|---|---|
snapshot | SnapshotContext / SnapshotReference | 是 | 本次查询实际使用的数据版本。 |
relation_id | string | 是 | ETF 与板块关系的稳定标识。 |
items | array<EtfRelationChangeEvent> | 是 | 当前查询返回的结果列表。 |
pagination | Pagination | 是 | 分页位置、总数和总页数。 |
EtfRelationChangeEvent
| 字段 | 类型 | 必有 | 含义 |
|---|---|---|---|
event_id | string | 是 | ETF 板块关系变化事件的稳定标识。 |
run_id | string | 是 | 产生该事件的完整数据运行标识。 |
relation_id | string | 是 | ETF 与板块关系的稳定标识。 |
as_of | string | 是 | 该数据版本对应的业务日期。 |
etf_key | string | 是 | 包含交易所前缀的稳定 ETF 标识。 |
sector_id | string | 是 | 板块稳定标识。 |
event_type | string | 是 | 关系创建、状态跨档、显著暴露变化或失效。 |
previous_status | string / null | 否 | 变化前的关系状态；首次创建时为空。 |
new_status | string | 是 | 变化后的关系状态。 |
previous_exposure | number / null | 否 | 变化前的调整暴露；首次创建时为空。 |
new_exposure | number | 是 | 变化后的调整暴露。 |
exposure_delta | number | 是 | 调整暴露的有符号变化量。 |
absolute_delta | number | 是 | 调整暴露变化量的绝对值。 |
relative_delta | number / null | 否 | 相对前值的暴露变化比例；前值为零时为空。 |
previous_basket_id | string | 否 | 变化前使用的 ETF 篮子标识。 |
new_basket_id | string | 否 | 变化后使用的 ETF 篮子标识。 |
previous_mapping_run_id | string | 否 | 变化前使用的公司板块映射运行标识。 |
new_mapping_run_id | string | 否 | 变化后使用的公司板块映射运行标识。 |
reason | string | 是 | 形成该变化事件的机器可读原因。 |
drivers | array<string> | 否 | 导致关系变化的篮子、公司映射或阈值因素。 |
significant_exposure_change | boolean | 否 | 暴露变化是否达到显著变化记录阈值。 |
created_at | string | 是 | 变化事件的入库时间。 |
调用要点
- Agent 建议使用
detail=compact控制上下文体积。 - 分页从
page_size=10开始，确认需要后再继续翻页。 - 需要解释结论时，再调用关联证据能力。