etf-description-all

# ETF-查询全部ETF基础信息 ## 1. 接口描述 | 项目 | 说明 | |------|------| | 接口名称 | 查询全部ETF基础信息 | | 外部接口 | `/api/v1/market/data/etf-description-all` | | 请求方式 | GET | | 适用场景 | 获取 ETF 列表（代码与名称）及部分基础属性信息，用于列表展示、筛选与检索 | ## 2. 请求参数 说明：该接口无需请求参数 | 参数名 | 类型 | 是否必填 | 描述 | 取值示例 | 备注 | |--------|------|----------|------|----------|------| | - | - | - | 无需参数 | - | - | ## 3. 响应说明 返回值为 ETF 基础信息数组，数据模型如下： ```json [ EtfDescriptionItem ] ``` ### EtfDescriptionItem 结构 | 字段名 | 类型 | 是否可为空 | 说明 | 单位 | |--------|------|------------|------|------| | asset_class | String | 否 | 基金类型，当前外部返回小写字符串（如 `stock`、`bond`、`commodity`、`currency`） | - | | custodian | String | 否 | 基金托管人（通常为托管银行） | - | | float_shares | int | 是 | 流通份额，无数据时为 null | 份 | | inception_date | String | 否 | 成立日期，格式 `YYYY-MM-DD` | - | | management_company | String | 否 | 基金管理人 | - | | name | String | 否 | ETF 名称 | - | | symbol | String | 否 | ETF 标的代码，带交易所后缀 | - | ## 4. 用法 通过主目录 `run.py` 调用（无需参数）： ```bash python <RUN_PY> etf-description-all ``` `<RUN_PY>` 为主 SKILL.md 同级的 `run.py` 绝对路径。脚本输出 JSON 数组，可直接用于“名称 -> symbol”映射。 ## 5. 请求示例 ``` GET /api/v1/market/data/etf-description-all ``` ## 6. 响应示例 ```json [ { "asset_class": "currency", "custodian": "交通银行", "float_shares": 3955933, "inception_date": "2013-03-29", "management_company": "易方达基金", "name": "货币ETF易方达", "symbol": "159001.XSHE" } ] ``` ## 7. 数据更新时间与注意事项 - 数据更新时间以接口/数据源为准。 - 当用户只给 ETF 名称或简称时，建议先调用本接口做名称匹配，拿到唯一 `symbol` 后再调用 `etf-detail`、`etf-ohlcs`、`etf-prices`、`etf-component`、`etf-pre-single`。 - 若名称匹配到多个 `symbol`，先让用户确认目标标的，再继续查询指标。