Skill v1.0.1

currentLLM-judged scan90/100

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

+1 new

──Details

PublishedOctober 24, 2026 at 12:54 PM

Content Hashsha256:925ffe5007427fcc...

Git SHAf6840b1dbeae

Bump Typepatch

Compare with v1.0.0

──Files

Files (1 file, 4.1 KB)

SKILL.md4.1 KBactive

SKILL.md · 68 lines · 4.1 KB

version: "1.0.1" name: etf-candlesticks-batch description: 批量查询多只 ETF 的历史 K 线（etf_candlesticks_batch）。用户问多只 ETF 日/周/月/年 K 线、批量 ETF 开高低收、ETF 批量行情、多 ETF 对比 K 线时使用。

批量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 数据计算，不含实时行情，实际起始日期以行情数据源覆盖为准。

← v1.0.0 All versions