Etf Detail

单只 ETF 详情 - 查询单只 ETF 详情

1. 接口描述

| 项目 | 说明 | |------|------| | 接口名称 | 查询单只 ETF 详情 | | 外部接口 | GET /api/v1/market/data/daec/etf?symbol=:etf | | 请求方式 | GET | | 适用场景 | 获取 A 股指定 ETF 的详情（名称、行情、盘口、市值、涨跌幅、跟踪指数、投资类型等）；支持通过 masks 按需返回部分字段；带登录态时可能包含是否在默认分组 |

2. 请求参数

说明：etf 为路径参数（必填），masks 为可选项。

| 参数名 | 类型 | 是否必填 | 描述 | 取值示例 | 备注 | |--------|------|----------|------|----------|------| | etf | string | 是 | ETF 标的键（路径参数，带市场后缀） | 510050.XSHG、159915.XSHE、920036.BJ | 沪 .XSHG、深 .XSHE、北交所 .BJ | | masks | string | 否 | 字段掩码，逗号分隔的字段名，仅返回这些字段 | name,symkey,latest,change_rate | 不传则返回全部字段；字段名须匹配正则 ^[a-zA-Z_][a-zA-Z0-9_]*$，非法字段名会报错 |

3. 响应说明

返回单只 ETF 对象。不传 masks 时返回全部字段，传 masks 时仅返回指定字段；各字段均可能为 null 或不存在。价格类保留 4 位小数。

{
    "name": "上证50ETF",
    "symkey": "510050.XSHG",
    "latest": 2.85,
    "prev_close": 2.845,
    "change_rate": 0.0018,
    "volume": 125000000,
    "turnover": 356000000.0,
    "tracking_index_symkey": "000016.XSHG"
}

根字段（部分常用）

| 字段名 | 类型 | 是否可为空 | 说明 | 单位 | |--------|------|------------|------|------| | name | string | 是 | ETF 名称 | — | | symkey | string | 是 | 标的键 | — | | symbolid | string | 是 | 标的 ID | — | | exid | string | 是 | 市场 ID | — | | trackingindexsymkey | string | 是 | 跟踪指数标的键 | — | | latest | float | 是 | 最新价 | 元 | | close | float | 是 | 收盘价 | 元 | | open | float | 是 | 开盘价 | 元 | | high | float | 是 | 最高价 | 元 | | low | float | 是 | 最低价 | 元 | | prevclose | float | 是 | 昨收价 | 元 | | limitup | float | 是 | 涨停价 | 元 | | limitdown | float | 是 | 跌停价 | 元 | | change | float | 是 | 涨跌额 | 元 | | changerate | float | 是 | 涨跌幅 | % | | volume | long | 是 | 成交量 | 份 | | turnover | float | 是 | 成交额 | 元 | | turnoverrate | float | 是 | 换手率 | % | | marketcaptotal | float | 是 | 总市值 | 元 | | marketcapcirculating | float | 是 | 流通市值 | 元 | | investkind | string | 是 | 投资标的类型 | — | | investstrategy | string | 是 | 投资策略分类 | — | | trademode | string | 是 | 交易模式 | — | | isindefaultchoicegroup | boolean | 是 | 是否在默认分组（需登录） | — |

4. 用法

通过主目录 run.py 调用（必填 --etf，可选 --masks）：

python  etf-detail --etf 510050.XSHG
python  etf-detail --etf 159915.XSHE --masks name,symkey,latest,change_rate,volume,turnover

` 为主 SKILL.md 同级的 run.py 绝对路径。脚本输出 JSON，请求头已内置 X-Client-Name: ft-claw`。

5. 请求示例

GET /api/v1/market/data/daec/etf?symbol=510050.XSHG

6. 注意事项

• 涨跌幅 change_rate 等比率字段在接口中可能为小数形式，展示时按需乘以 100 转为百分比
• 成交量、成交额、市值等大数字展示时可按需换算单位（如万、亿）
• 完整字段以代码 Etf 为准；未传 masks 时返回全部可用字段

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: FTShare-Lab
• Source: FTShare-Lab/FTShare-skills
• License: MIT
• Homepage: https://github.com/ftshare-lab/FTShare-skills

Install and usage instructions live in the source repository linked above.