ETF 与板块映射

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

能力

任务	能力
查询 ETF 目录	etf.list
获取 ETF 及板块概况	etf.detail
ETF 反查板块	etf.sectors.list
板块反查 ETF	etf.by_sector.list
审计映射依据	etf.relation.evidence
审计完整贡献链	etf.relation.contributions
查询关系变化	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 篮子、公司关系和板块目录。