ftshare-lab/ftshare-skill/etf-candlesticks-batch

Name: etf-candlesticks-batch
Author: ftshare-lab

Trust tier 3

community

By ftshare-lab
Coding
ftshare-lab/ftshare-skill
ftshare-market-data/sub-skills/etf-candlesticks-batch/SKILL.md
Updated 24 Oct 2026
Version 1.0.12 versions recorded

Source check pending

Checking that the SKILL.md file is still in the repository.

批量查询多只 ETF 的历史 K 线（etf_candlesticks_batch）。用户问多只 ETF 日/周/月/年 K 线、批量 ETF 开高低收、ETF 批量行情、多 ETF 对比 K 线时使用。

Install

npx vskill@latest install ftshare-lab/ftshare-skill/etf-candlesticks-batch

SKILL.md

批量ETFK线

1. 接口描述

项目	说明
接口名称	批量ETFK线（etf_candlesticks_batch）
外部接口	`GET /api/v2/market/data/etf-candlesticks/batch`
请求方式	GET（query 参数，`symbols` 使用逗号分隔）
适用场景	一次批量获取多只 ETF 的历史 K 线（开高低收、成交量、成交额、换手率），支持日/周/月/年周期与前复权/后复权

2. 请求参数

参数名	类型	是否必填	描述	取值示例	备注
symbols	string	是	ETF 代码列表，逗号分隔传给 CLI	510300.SH,159915.SZ	沪市支持 `.XSHG`/`.SH`，深市支持 `.XSHE`/`.SZ`；接口侧以逗号分隔发送 `symbols=510300.SH,159915.SZ`，兼容旧的重复参数和 JSON 字符串数组格式
interval_unit	string	是	周期单位	day	day/week/month/year（大小写不敏感）；不支持 minute
adjust_kind	string	否	复权类型	forward	none（默认，不复权）/forward（前复权）/backward（后复权）
since_ts_millis	int	否	开始时间戳（毫秒）	1756431000000	与 limit 至少填一个；与 until 的跨度不得超过 12 个自然月，且不得晚于 until
until_ts_millis	int	是	结束时间戳（毫秒）	1756791000000	-
limit	int	否	每个标的返回条数上限	2	不传时返回请求时间范围内的全部数据

3. 响应说明

外层固定为 code（成功 200）/ message（成功 success）/ data（失败时为 null）。data 为按请求顺序排列的非分页分组数组，每项结构为 {symbol, items, total}：

字段名	类型	说明
symbol	string	ETF 代码，响应统一使用 `.SH`、`.SZ` 短后缀
items	array	该标的的 K 线数组；无数据时为 `[]`
total	integer	`items` 的 K 线条数；无数据时为 0

items 中每根 K 线字段：

字段名	类型	说明	单位
open / high / low / close	string	开/高/低/收盘价；JSON 中为字符串以保留精度	元
ts_millis	integer	收盘时间戳	毫秒
ts_millis_open	integer	开盘时间戳	毫秒
turnover	string	成交额；JSON 中为字符串以保留精度	元
volume	integer	成交量	-
turnover_rate	number / null	换手率；ETF 批量历史 K 线当前固定为 `null`	%

4. 调用方式

bash

python <RUN_PY> etf-candlesticks-batch --symbols 510300.SH,159915.SZ --interval-unit day --since-ts-millis 1756431000000 --until-ts-millis 1756791000000 --limit 2
python <RUN_PY> etf-candlesticks-batch --symbols 510300.XSHG,159915.XSHE --interval-unit week --adjust-kind forward --since-ts-millis 1754092800000 --until-ts-millis 1756791000000

<RUN_PY> 为主 SKILL.md 同级 run.py 的绝对路径。输出 JSON；HTTP 错误输出到 stderr 并以非零状态退出。

5. 注意事项

symbols、interval_unit、until_ts_millis 必填；since_ts_millis 与 limit 至少填一个；所有 symbols 使用相同周期。
接口仅支持 GET；symbols 使用逗号分隔发送（symbols=510300.SH,159915.SZ），兼容旧的重复参数和 JSON 字符串数组格式。
时间跨度最多 12 个自然月；需要更长历史时按窗口分段多次调用。
不支持分钟 K 线；分钟数据请使用 etf-minutes-batch 子 skill（interval_unit=minute 会返回参数错误）。
symbols 中每项必须是 ETF 标的：若混入非 ETF（如股票），整个批量请求失败，不静默过滤（当前返回系统错误）。
输入 .XSHG/.XSHE 长后缀时，响应中的 symbol 会规范化为 .SH、.SZ 短后缀。
默认不复权（none）；仅使用历史日 K 数据计算，不含实时行情，实际起始日期以行情数据源覆盖为准。

Security

Security scanPassed, 90 of 100Pattern checks on the skill's files.
Model reviewPassed

See the full security report

Quality evaluation

Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

See evaluation results

Source

SKILL.md in the repositoryCheckingftshare-market-data/sub-skills/etf-candlesticks-batch/SKILL.md

Popularity

Repository stars: 65
Repository forks: 14
7-day trend score: 26

Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

Claude Code
Cursor
GitHub Copilot
Windsurf
Codex
Gemini CLI
Cline
Amp
Roo Code
Goose
Continue
Kilo Code
Junie
Trae
OpenHands
Qwen Code
AI Agent
Tabnine Chat
Sourcegraph Cody
Amazon Q
Firebase Genkit
Sweep
Devin
Phind
Mentat
Claude Desktop
Aider
GPT Pilot
Plandex
bolt.new
v0
Replit Agent
Anse
TypingMind
BetterChatGPT
LibreChat
Warp AI
Pieces
Fig AI

Embed badge

[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/ftshare-lab/ftshare-skill/etf-candlesticks-batch/badge)](https://verified-skill.com/skills/ftshare-lab/ftshare-skill/etf-candlesticks-batch)

Something wrong with this skill or its page? Tell us.