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	是	标的键	—
symbol_id	string	是	标的 ID	—
ex_id	string	是	市场 ID	—
tracking_index_symkey	string	是	跟踪指数标的键	—
latest	float	是	最新价	元
close	float	是	收盘价	元
open	float	是	开盘价	元
high	float	是	最高价	元
low	float	是	最低价	元
prev_close	float	是	昨收价	元
limit_up	float	是	涨停价	元
limit_down	float	是	跌停价	元
change	float	是	涨跌额	元
change_rate	float	是	涨跌幅	%
volume	long	是	成交量	份
turnover	float	是	成交额	元
turnover_rate	float	是	换手率	%
market_cap_total	float	是	总市值	元
market_cap_circulating	float	是	流通市值	元
invest_kind	string	是	投资标的类型	—
invest_strategy	string	是	投资策略分类	—
trade_mode	string	是	交易模式	—
is_in_default_choice_group	boolean	是	是否在默认分组（需登录）	—

4. 用法

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

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

<RUN_PY> 为主 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 时返回全部可用字段