$npx -y skills add FTShare-Lab/FTShare-skills --skill etf-description-all查询全部 ETF 基础信息(market.ft.tech)。用户问 ETF 列表、全部 ETF、ETF 代码与名称映射、按名称找 ETF 代码时使用。
| 1 | # ETF-查询全部ETF基础信息 |
| 2 | |
| 3 | ## 1. 接口描述 |
| 4 | |
| 5 | | 项目 | 说明 | |
| 6 | |------|------| |
| 7 | | 接口名称 | 查询全部ETF基础信息 | |
| 8 | | 外部接口 | `/api/v1/market/data/etf-description-all` | |
| 9 | | 请求方式 | GET | |
| 10 | | 适用场景 | 获取 ETF 列表(代码与名称)及部分基础属性信息,用于列表展示、筛选与检索 | |
| 11 | |
| 12 | ## 2. 请求参数 |
| 13 | |
| 14 | 说明:该接口无需请求参数 |
| 15 | |
| 16 | | 参数名 | 类型 | 是否必填 | 描述 | 取值示例 | 备注 | |
| 17 | |--------|------|----------|------|----------|------| |
| 18 | | - | - | - | 无需参数 | - | - | |
| 19 | |
| 20 | ## 3. 响应说明 |
| 21 | |
| 22 | 返回值为 ETF 基础信息数组,数据模型如下: |
| 23 | |
| 24 | ```json |
| 25 | [ |
| 26 | EtfDescriptionItem |
| 27 | ] |
| 28 | ``` |
| 29 | |
| 30 | ### EtfDescriptionItem 结构 |
| 31 | |
| 32 | | 字段名 | 类型 | 是否可为空 | 说明 | 单位 | |
| 33 | |--------|------|------------|------|------| |
| 34 | | asset_class | String | 否 | 基金类型,当前外部返回小写字符串(如 `stock`、`bond`、`commodity`、`currency`) | - | |
| 35 | | custodian | String | 否 | 基金托管人(通常为托管银行) | - | |
| 36 | | float_shares | int | 是 | 流通份额,无数据时为 null | 份 | |
| 37 | | inception_date | String | 否 | 成立日期,格式 `YYYY-MM-DD` | - | |
| 38 | | management_company | String | 否 | 基金管理人 | - | |
| 39 | | name | String | 否 | ETF 名称 | - | |
| 40 | | symbol | String | 否 | ETF 标的代码,带交易所后缀 | - | |
| 41 | |
| 42 | ## 4. 用法 |
| 43 | |
| 44 | 通过主目录 `run.py` 调用(无需参数): |
| 45 | |
| 46 | ```bash |
| 47 | python <RUN_PY> etf-description-all |
| 48 | ``` |
| 49 | |
| 50 | `<RUN_PY>` 为主 SKILL.md 同级的 `run.py` 绝对路径。脚本输出 JSON 数组,可直接用于“名称 -> symbol”映射。 |
| 51 | |
| 52 | ## 5. 请求示例 |
| 53 | |
| 54 | ``` |
| 55 | GET /api/v1/market/data/etf-description-all |
| 56 | ``` |
| 57 | |
| 58 | ## 6. 响应示例 |
| 59 | |
| 60 | ```json |
| 61 | [ |
| 62 | { |
| 63 | "asset_class": "currency", |
| 64 | "custodian": "交通银行", |
| 65 | "float_shares": 3955933, |
| 66 | "inception_date": "2013-03-29", |
| 67 | "management_company": "易方达基金", |
| 68 | "name": "货币ETF易方达", |
| 69 | "symbol": "159001.XSHE" |
| 70 | } |
| 71 | ] |
| 72 | ``` |
| 73 | |
| 74 | ## 7. 数据更新时间与注意事项 |
| 75 | |
| 76 | - 数据更新时间以接口/数据源为准。 |
| 77 | - 当用户只给 ETF 名称或简称时,建议先调用本接口做名称匹配,拿到唯一 `symbol` 后再调用 `etf-detail`、`etf-ohlcs`、`etf-prices`、`etf-component`、`etf-pre-single`。 |
| 78 | - 若名称匹配到多个 `symbol`,先让用户确认目标标的,再继续查询指标。 |