ftshare-lab/ftshare-skill/etf-candlesticks

Name: etf-candlesticks
Author: ftshare-lab

Trust tier 3

community

By ftshare-lab
Coding
ftshare-lab/ftshare-skill
ftshare-market-data/sub-skills/etf-candlesticks/SKILL.md
Updated 25 Oct 2026
Version 1.0.01 version recorded

Source check pending

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

单只 ETF 历史日/周/月/年 K 线 GET 接口（market.ft.tech，etf-candlesticks）。用户问某只 ETF 的日/周/月/年 K 线、开高低收、前/后复权、日 K/周 K/月 K/年 K 时使用。必填 --symbol、--interval-unit、--since-ts-millis、--until-ts-millis；可选 --adjust-kind、--limit。分钟级 K 线请用 etf-minutes。

Install

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

SKILL.md

The same SKILL.md was published earlier as majiayu000/claude-skill-registry/etf-candlesticks.

ETF K 线 - 查询单只 ETF 历史 K 线（etf-candlesticks）

1. 接口描述

项目	说明
接口名称	查询单只 ETF 历史 K 线
外部接口	`GET /api/v1/market/data/etf-candlesticks`
请求方式	GET（query 参数）
适用场景	获取指定 ETF 的日/周/月/年 K 线，含开高低收、成交量、成交额；支持前复权 / 后复权 / 不复权。仅接受 ETF 标的

与 etf-ohlcs（GET daec/history/ohlcs，YYYYMMDD 日期区间，仅日/周/月）区别：本接口走 GET query 参数，参数为毫秒时间戳，支持日/周/月/年 K，是统一的 candlesticks 契约。分钟级 K 线请使用 etf-minutes 子 skill。

2. 请求参数

参数名	类型	是否必填	描述	取值示例	备注
symbol	string	是	ETF 代码（带市场后缀）	510300.XSHG、159915.XSHE	也接受 `.SH`/`.SZ` 短后缀；非 ETF 标的当前返回系统错误
interval_unit	string	是	周期单位	day	day/week/month/year（大小写不敏感，不支持 minute）
adjust_kind	string	否	复权类型	forward	none（默认，不复权）/forward（前复权）/backward（后复权）
since_ts_millis	int	是	开始时间戳（毫秒）	1756700000000	与 until 的跨度不得超过 12 个自然月
until_ts_millis	int	是	结束时间戳（毫秒）	1756791000000	-
limit	int	否	返回条数上限	5	不传时返回请求时间范围内的全部数据

3. 响应说明

返回裸数组，每根 K 线包含：

字段名	类型	说明	单位
open	string	开盘价	元
high	string	最高价	元
low	string	最低价	元
close	string	收盘价（或最新价）	元
ts_millis	int	收盘时间戳	毫秒
ts_millis_open	int	开盘时间戳	毫秒
turnover	string	成交额	元
volume	int64	成交量	份

4. 调用方式

通过主目录 run.py 调用：

bash

python <RUN_PY> etf-candlesticks --symbol 510300.XSHG --interval-unit day --since-ts-millis 1756700000000 --until-ts-millis 1756791000000 --limit 5
python <RUN_PY> etf-candlesticks --symbol 510300.XSHG --interval-unit week --adjust-kind forward --since-ts-millis 1756700000000 --until-ts-millis 1756791000000 --limit 100

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

直接执行 handler（调试）

bash

python scripts/handler.py --symbol 510300.XSHG --interval-unit day --until-ts-millis 1756791000000 --limit 5

5. 注意事项

symbol、interval_unit、since_ts_millis、until_ts_millis 必填。
symbol 必须是 ETF 代码，格式 {代码}.{市场}；非 ETF 标的当前外部接口返回系统错误。
本接口不支持分钟周期：interval_unit=minute 会返回参数错误（提示使用 /etf_minutes），分钟数据请使用 etf-minutes 子 skill。
时间跨度最多 12 个自然月；需要更长历史时按窗口分段多次调用。
默认不复权（none），forward 前复权、backward 后复权（取值大小写不敏感）。
价格字段 JSON 中为字符串以避免精度丢失。

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/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/badge)](https://verified-skill.com/skills/ftshare-lab/ftshare-skill/etf-candlesticks)

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