---
title: "查询 ETF 板块暴露变化"
description: "返回关系创建、状态跨档、显著暴露变化和失效事件，并说明变化来源。"
pageClass: gendangzou-doc
---

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

## 关联能力

- [`etf.relation.evidence`](/zh/gendangzou/capabilities/etf.relation.evidence)
- [`etf.relation.contributions`](/zh/gendangzou/capabilities/etf.relation.contributions)
- [`etf.sectors.list`](/zh/gendangzou/capabilities/etf.sectors.list)

## 机器可读契约

- [完整能力清单](/zh/gendangzou/agent-manifest.json)
- [在线能力详情](https://api.mobiusquant.ai/api/gendangzou/capabilities/etf.relation.changes)