获取 ETF 板块概况

etf.detail

返回 ETF 产品元数据、跟踪指数及可追溯板块暴露。

调用契约

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

受控意图：get_etf_detail、analyze_etf_exposure

请求参数

参数	位置	类型	必填	约束与默认值
`etf_code`	path	string	是	Six-digit fund code or stable SH./SZ. ETF key；匹配 `^(?😦?:SH
`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>?detail=compact"

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

响应

字段	类型	必有	含义
`snapshot`	`SnapshotContext / SnapshotReference`	是	本次查询实际使用的数据版本。
`etf`	`EtfDetail`	是	-

`EtfDetail`

字段	类型	必有	含义
`etf_key`	`string`	是	包含交易所前缀的稳定 ETF 标识。
`fund_code`	`string`	是	保留前导零的六位基金代码。
`name`	`string`	是	对象名称。
`full_name`	`string`	否	产品或公司的公开全称。
`manager`	`string`	否	-
`market`	`string`	否	市场标识。
`exchange`	`string`	是	上市交易所。
`product_scope`	`string`	是	ETF 产品范围：宽基或行业主题。
`product_status`	`string`	是	ETF 产品在当前版本中的状态。
`tracking_index_code`	`string`	否	ETF 跟踪指数代码。
`tracking_index_name`	`string`	否	ETF 跟踪指数名称。
`tracking_group_id`	`string`	否	按跟踪指数归并同类 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 原文实际获取时间。
`relation_count`	`integer`	否	ETF 在当前版本中的有效板块关系数量。
`top_sector_id`	`string`	否	ETF 当前调整暴露最高的板块标识。
`top_sector_name`	`string`	否	ETF 当前调整暴露最高的板块名称。
`top_adjusted_exposure`	`number`	否	ETF 当前最高的调整后板块暴露。
`sectors`	`array<EtfSectorRelation>`	否	当前对象关联的板块摘要或映射结果。

`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 控制上下文体积。
需要解释结论时，再调用关联证据能力。

获取 ETF 板块概况

调用契约

请求参数

最小调用

响应

`EtfDetail`

`EtfSectorRelation`

调用要点

关联能力

机器可读契约

获取 ETF 板块概况 ​

调用契约 ​

请求参数 ​

最小调用 ​

响应 ​

EtfDetail ​

EtfSectorRelation ​

调用要点 ​

关联能力 ​

机器可读契约 ​

获取 ETF 板块概况

调用契约

请求参数

最小调用

响应

`EtfDetail`

`EtfSectorRelation`

调用要点

关联能力

机器可读契约