Informations de source
- Dépôt
- FTShare-Lab/FTShare-skills
- Dernière activité de la source
- 3 juillet 2026 à 09:05
- Langue détectée de SKILL.md
- chinois
- Étoiles
- 46
- Forks
- 7
Options d'installation
Le prompt qui vérifie d'abord la source est sélectionné par défaut. Vous pouvez passer à une commande directe ou télécharger une copie locale.
Vérifiez les fichiers source
Lisez SKILL.md et les fichiers associés affichés par SkillsMP avant de décider de l'installer.
Explorateur de fichiers
2 fichiersAffichage de SKILL.md
SKILL.md
Instructions source · Aperçu en lecture seule- name
- etf-component
- description
- 查询单只 ETF 成份。用户问某只 ETF 成份股、ETF 持仓、510300 成份、沪深300ETF 成份列表时使用。
# 查询单只 ETF 成份
## 1. 接口描述
| 项目 | 说明 |
|------|------|
| 接口名称 | 查询单只 ETF 成份 |
| 外部接口 | `GET /api/v1/market/data/etf-component` |
| 请求方式 | GET |
| 适用场景 | 根据标的代码查询单只 ETF 的成份股列表（成份股代码与名称）；未找到或报错时接口返回相应错误信息 |
## 2. 请求参数
| 参数名 | 类型 | 是否必填 | 描述 | 取值示例 | 备注 |
|--------|------|----------|------|----------|------|
| symbol | string | 是 | ETF 标的代码，带交易所后缀 | 510300.XSHG、159915.XSHE | 支持 510300.XSHG、510300.SH 等格式 |
## 3. 响应说明
返回单条 ETF 成份结构，与全量接口 `etf-components-all` 中单条结构一致。
```json
{
"symbol": "510300.SH",
"components": ["600000.SH", "601318.SH", "600519.SH"],
"components_name": ["浦发银行", "中国平安", "贵州茅台"]
}
```
### 根字段说明
| 字段名 | 类型 | 是否可为空 | 说明 |
|--------|------|------------|------|
| symbol | string | 否 | ETF 标的代码，带市场后缀 |
| components | array | 否 | 成份股代码列表，与 components_name 一一对应 |
| components_name | array | 否 | 成份股名称列表，与 components 一一对应 |
## 4. 用法
通过主目录 `run.py` 调用（必填 `--symbol`）：
```bash
python <RUN_PY> etf-component --symbol 510300.XSHG
python <RUN_PY> etf-component --symbol 159915.XSHE
```
`<RUN_PY>` 为主 SKILL.md 同级的 `run.py` 绝对路径。脚本输出 JSON；接口报错或未找到时，将接口返回的错误信息原样输出到 stderr 并退出码 1。
## 5. 请求示例
```
GET /api/v1/market/data/etf-component?symbol=510300.XSHG
```
## 6. 数据更新时间与注意事项
- 数据更新时间以接口/数据源为准。
- 成份列表与名称以接口返回为准；展示时 `components` 与 `components_name` 按索引一一对应。
Voir sur GitHub