etf-detail
starsforks
How to install etf-detail?
ftshare-lab/ftshare-skills/etf-detail
$npx -y skills add FTShare-Lab/FTShare-skills --skill etf-detailGet single ETF detail (单只 ETF 详情). Use when user asks about 某只 ETF 详情、ETF 行情、510050 行情、上证50ETF、ETF 名称/涨跌幅/跟踪指数/市值.
SKILL.md
| 1 | # 单只 ETF 详情 - 查询单只 ETF 详情 |
| 2 | |
| 3 | ## 1. 接口描述 |
| 4 | |
| 5 | | 项目 | 说明 | |
| 6 | |------|------| |
| 7 | | 接口名称 | 查询单只 ETF 详情 | |
| 8 | | 外部接口 | `GET /api/v1/market/data/daec/etf?symbol=:etf` | |
| 9 | | 请求方式 | GET | |
| 10 | | 适用场景 | 获取 A 股指定 ETF 的详情（名称、行情、盘口、市值、涨跌幅、跟踪指数、投资类型等）；支持通过 masks 按需返回部分字段；带登录态时可能包含是否在默认分组 | |
| 11 | |
| 12 | ## 2. 请求参数 |
| 13 | |
| 14 | 说明：`etf` 为路径参数（必填），`masks` 为可选项。 |
| 15 | |
| 16 | | 参数名 | 类型 | 是否必填 | 描述 | 取值示例 | 备注 | |
| 17 | |--------|------|----------|------|----------|------| |
| 18 | | etf | string | 是 | ETF 标的键（路径参数，带市场后缀） | 510050.XSHG、159915.XSHE、920036.BJ | 沪 .XSHG、深 .XSHE、北交所 .BJ | |
| 19 | | masks | string | 否 | 字段掩码，逗号分隔的字段名，仅返回这些字段 | name,symkey,latest,change_rate | 不传则返回全部字段；字段名须匹配正则 `^[a-zA-Z_][a-zA-Z0-9_]*$`，非法字段名会报错 | |
| 20 | |
| 21 | ## 3. 响应说明 |
| 22 | |
| 23 | 返回单只 ETF 对象。不传 `masks` 时返回全部字段，传 `masks` 时仅返回指定字段；各字段均可能为 null 或不存在。价格类保留 4 位小数。 |
| 24 | |
| 25 | ```json |
| 26 | { |
| 27 | "name": "上证50ETF", |
| 28 | "symkey": "510050.XSHG", |
| 29 | "latest": 2.85, |
| 30 | "prev_close": 2.845, |
| 31 | "change_rate": 0.0018, |
| 32 | "volume": 125000000, |
| 33 | "turnover": 356000000.0, |
| 34 | "tracking_index_symkey": "000016.XSHG" |
| 35 | } |
| 36 | ``` |
| 37 | |
| 38 | ### 根字段（部分常用） |
| 39 | |
| 40 | | 字段名 | 类型 | 是否可为空 | 说明 | 单位 | |
| 41 | |--------|------|------------|------|------| |
| 42 | | name | string | 是 | ETF 名称 | — | |
| 43 | | symkey | string | 是 | 标的键 | — | |
| 44 | | symbol_id | string | 是 | 标的 ID | — | |
| 45 | | ex_id | string | 是 | 市场 ID | — | |
| 46 | | tracking_index_symkey | string | 是 | 跟踪指数标的键 | — | |
| 47 | | latest | float | 是 | 最新价 | 元 | |
| 48 | | close | float | 是 | 收盘价 | 元 | |
| 49 | | open | float | 是 | 开盘价 | 元 | |
| 50 | | high | float | 是 | 最高价 | 元 | |
| 51 | | low | float | 是 | 最低价 | 元 | |
| 52 | | prev_close | float | 是 | 昨收价 | 元 | |
| 53 | | limit_up | float | 是 | 涨停价 | 元 | |
| 54 | | limit_down | float | 是 | 跌停价 | 元 | |
| 55 | | change | float | 是 | 涨跌额 | 元 | |
| 56 | | change_rate | float | 是 | 涨跌幅 | % | |
| 57 | | volume | long | 是 | 成交量 | 份 | |
| 58 | | turnover | float | 是 | 成交额 | 元 | |
| 59 | | turnover_rate | float | 是 | 换手率 | % | |
| 60 | | market_cap_total | float | 是 | 总市值 | 元 | |
| 61 | | market_cap_circulating | float | 是 | 流通市值 | 元 | |
| 62 | | invest_kind | string | 是 | 投资标的类型 | — | |
| 63 | | invest_strategy | string | 是 | 投资策略分类 | — | |
| 64 | | trade_mode | string | 是 | 交易模式 | — | |
| 65 | | is_in_default_choice_group | boolean | 是 | 是否在默认分组（需登录） | — | |
| 66 | |
| 67 | ## 4. 用法 |
| 68 | |
| 69 | 通过主目录 `run.py` 调用（必填 `--etf`，可选 `--masks`）： |
| 70 | |
| 71 | ```bash |
| 72 | python <RUN_PY> etf-detail --etf 510050.XSHG |
| 73 | python <RUN_PY> etf-detail --etf 159915.XSHE --masks name,symkey,latest,change_rate,volume,turnover |
| 74 | ``` |
| 75 | |
| 76 | `<RUN_PY>` 为主 SKILL.md 同级的 `run.py` 绝对路径。脚本输出 JSON，请求头已内置 `X-Client-Name: ft-claw`。 |
| 77 | |
| 78 | ## 5. 请求示例 |
| 79 | |
| 80 | ``` |
| 81 | GET /api/v1/market/data/daec/etf?symbol=510050.XSHG |
| 82 | ``` |
| 83 | |
| 84 | ## 6. 注意事项 |
| 85 | |
| 86 | - 涨跌幅 `change_rate` 等比率字段在接口中可能为小数形式，展示时按需乘以 100 转为百分比 |
| 87 | - 成交量、成交额、市值等大数字展示时可按需换算单位（如万、亿） |
| 88 | - 完整字段以代码 `Etf` 为准；未传 `masks` 时返回全部可用字段 |
People who liked this also viewed
6 picksType
- azure-costAzure cost management: query costs, forecast spending, optimize to reduce waste. WHEN: \"Azure costs\", \"Azure bill\", \"cost breakdown\", \"how much am I spending\", \"forecast spending\", \"optimizSkillsJul 2026
- pricingWhen the user wants help with pricing decisions, packaging, or monetization strategy. Also use when the user mentions 'pricing,' 'pricing tiers,' 'freemium,' 'free trial,' 'packaging,' 'price increaseSkillsJul 2026
- stripe-integrationMulti-harness agentic plugin marketplace for Claude Code, Codex CLI, Cursor, OpenCode, GitHub Copilot, and Gemini CLISkillsJul 2026
- startup-financial-modelingMulti-harness agentic plugin marketplace for Claude Code, Codex CLI, Cursor, OpenCode, GitHub Copilot, and Gemini CLISkillsJul 2026
- tushare-finance专为 Claude Code 设计的 Tushare Pro 金融数据技能包，支持 220+ 个接口，用自然语言获取 A 股行情、财务数据、宏观经济等金融数据。SkillsJul 2026
- azure-pricingFetches real-time Azure retail pricing using the Azure Retail Prices API (prices.azure.com) and estimates Copilot Studio agent credit consumption. Use when the user asks about the cost of any Azure seSkillsJul 2026
