来源信息
- 仓库
- FTShare-Lab/FTShare-skills
- 最近来源活动
- 2026年7月3日 09:05
- 检测到的 SKILL.md 语言
- 中文
- 星标
- 46
- 分支
- 7
安装方式
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
检查来源文件
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
文件资源管理器
2 个文件正在显示 SKILL.md
SKILL.md
来源说明 · 只读预览- 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` 按索引一一对应。
在 GitHub 查看