---
title: ETF 与板块映射
description: 境内被动权益 ETF 与自有板块体系的双向、可追溯映射。
pageClass: gendangzou-doc
---

# ETF 与板块映射

ETF 映射覆盖沪深交易所上市的境内被动权益 ETF。产品名称只用于检索，关系依据是
交易所每日 PCF 申购赎回篮子，以及同一完整数据版本中的公司板块关系。

## 能力

| 任务 | 能力 |
| --- | --- |
| 查询 ETF 目录 | [`etf.list`](/zh/gendangzou/capabilities/etf.list) |
| 获取 ETF 及板块概况 | [`etf.detail`](/zh/gendangzou/capabilities/etf.detail) |
| ETF 反查板块 | [`etf.sectors.list`](/zh/gendangzou/capabilities/etf.sectors.list) |
| 板块反查 ETF | [`etf.by_sector.list`](/zh/gendangzou/capabilities/etf.by_sector.list) |
| 审计映射依据 | [`etf.relation.evidence`](/zh/gendangzou/capabilities/etf.relation.evidence) |
| 审计完整贡献链 | [`etf.relation.contributions`](/zh/gendangzou/capabilities/etf.relation.contributions) |
| 查询关系变化 | [`etf.relation.changes`](/zh/gendangzou/capabilities/etf.relation.changes) |

## 口径

- `product_scope=broad` 表示宽基，`product_scope=sector` 表示行业或主题产品。
- `exposure_ratio` 是篮子映射到板块的原始持仓权重。
- `adjusted_exposure` 叠加公司关系分、置信度、状态和关系类型。
- `confidence` 综合公司关系置信度、持仓映射覆盖和篮子估值覆盖。
- `tracking_group_id` 用于归并跟踪同一指数的产品。

债券、货币、商品、跨境、QDII、REITs、LOF、联接、增强和主动产品不纳入。关系
状态只描述暴露强弱，不表示产品推荐、收益预期或买卖建议。

## 更新机制

每个完整数据版本都会先核验交易所 ETF 目录和篮子日期。官方日期未变时复用已验证的
PCF；日期变化或产品首次出现时，重新下载并解析篮子。公司板块关系根据新增财报、公告
和市场材料更新，ETF 板块暴露随后基于同一版本重新计算。

板块目录遵循稳定身份和既定治理周期。展示名称调整不改变 `sector_id`，ETF、公司和
板块之间的关系不是三张彼此独立的静态映射表。

| 字段 | 含义 |
| --- | --- |
| `basket_date` | 交易所 PCF 对应的业务日期 |
| `basket_checked_as_of` | 系统最近一次向交易所目录核验篮子日期的日期 |
| `refreshed` | 本轮已重新获取和解析 PCF |
| `verified_unchanged` | 本轮已核验，官方篮子日期未变化 |
| `carried_forward` | 来源异常，本轮降级沿用既有篮子 |
| `unknown` | 无法确认新鲜度 |

`basket_date` 早于版本日期不必然表示数据陈旧。例如休市日官方篮子未更新时，
`basket_checked_as_of` 和 `verified_unchanged` 才能说明本轮已经完成核验。

## 可溯源依据

`etf.relation.evidence` 返回交易所官方 PCF 链接、篮子日期、计算公式和主要成分贡献；
`etf.relation.contributions` 分页返回全部 ETF 成分、公司板块关系、权重调整因子和最终
贡献，适用于完整复核。

`etf.relation.changes` 返回关系创建、状态跨档、显著暴露变化和失效事件。绝对暴露变化
达到 2 个百分点，或达到配置的相对变化条件时，才记录显著暴露变化；更小的数值变化
仍保留在每日版本中。

历史查询应固定响应中的 `snapshot_id`，防止跨版本混用 ETF 篮子、公司关系和板块目录。