---
title: "反查 ETF 对应板块"
description: "依据官方申赎篮子、跟踪指数、公司关系和板块路径，查询 ETF 的直接或扩展板块关系。"
pageClass: gendangzou-doc
---

# 反查 ETF 对应板块

`etf.sectors.list`

依据官方申赎篮子、跟踪指数、公司关系和板块路径，查询 ETF 的直接或扩展板块关系。

## 调用契约

| 项目 | 值 |
| --- | --- |
| Method | `GET` |
| Path | `/api/gendangzou/etfs/{etf_code}/sectors` |
| 业务域 | `etf` |
| 数据更新 | 随交易所每日 PCF 和完整数据版本发布 |

受控意图：`list_etf_sectors`、`analyze_etf_exposure`

## 请求参数

| 参数 | 位置 | 类型 | 必填 | 约束与默认值 |
| --- | --- | --- | --- | --- |
| `etf_code` | path | string | 是 | 匹配 `^(?:(?:SH|SZ)\.)?[0-9]{6}$` |
| `status` | query | string | 否 | 默认 `active,watched,candidate`；最长 80 字符 |
| `min_exposure` | query | number | 否 | 默认 `0`；最小 0；最大 1 |
| `relation_scope` | query | string | 否 | Filter direct, lineage-expanded, related or reference relations；默认 `all`；可选 `all`、`direct`、`extended`、`related`、`reference` |
| `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/etfs/<etf_code>/sectors?page_size=10&detail=compact"
```

将路径中的 `<...>` 替换为实际资源 ID。

## 响应

| 字段 | 类型 | 必有 | 含义 |
| --- | --- | --- | --- |
| `snapshot` | `SnapshotContext / SnapshotReference` | 是 | 本次查询实际使用的数据版本。 |
| `items` | `array<EtfSectorRelation>` | 是 | 当前查询返回的结果列表。 |
| `pagination` | `Pagination` | 是 | 分页位置、总数和总页数。 |
| `coverage` | `object` | 否 | 数据覆盖数量与完成度统计。 |

### `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 板块关系贡献较高的篮子成分。 |

## 调用要点

- Agent 建议使用 `detail=compact` 控制上下文体积。
- 分页从 `page_size=10` 开始，确认需要后再继续翻页。
- 需要解释结论时，再调用关联证据能力。

## 关联能力

- [`etf.detail`](/zh/gendangzou/capabilities/etf.detail)
- [`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)

## 机器可读契约

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