股票 K 线 - 查询单只标的 K 线（stock-candlesticks）

1. 接口描述

项目	说明
接口名称	查询单只标的 K 线（通用）
外部接口	GET /api/v1/market/data/stock-candlesticks
请求方式	GET（query 参数）
适用场景	获取股票 / ETF / 指数 / 可转债等标的的日/周/月/年 K 线，含开高低收、成交量、成交额；支持前复权 / 后复权 / 不复权。通用语义，不做证券类别校验

本接口统一使用毫秒时间戳和 GET query 参数，支持日/周/月/年 K，并允许股票、ETF、指数、可转债等不同类别标的。分钟级 K 线请使用 stock-minutes 子 skill。

2. 请求参数

参数名	类型	是否必填	描述	取值示例	备注
symbol	string	是	标的代码（带市场后缀）	600519.SH、000001.SZ、510300.XSHG	长短后缀均支持；.XSHG/.SH、.XSHE/.SZ、.BJSE/.BJ
interval_unit	string	是	周期单位	day	day/week/month/year（大小写不敏感，不支持 minute）
adjust_kind	string	否	复权类型	forward	none（默认，不复权）/forward（前复权）/backward（后复权）
since_ts_millis	int	否	开始时间戳（毫秒）	1756700000000	与 limit 至少填一个；与 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	成交量	股/份
turnover_rate	number	换手率	%

4. 调用方式

python <RUN_PY> stock-candlesticks --symbol 600519.SH --interval-unit day --since-ts-millis 1756431000000 --until-ts-millis 1756710000000 --limit 5
python <RUN_PY> stock-candlesticks --symbol 000001.SZ --interval-unit week --adjust-kind forward --since-ts-millis 1756700000000 --until-ts-millis 1756791000000

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

5. 注意事项

• symbol、interval_unit、until_ts_millis 必填。
• symbol 必须带市场后缀；不带后缀或后缀无法识别时外部接口返回系统错误。
• 本接口不支持分钟周期：interval_unit=minute 会返回参数错误，分钟数据请使用 stock-minutes 子 skill。
• 时间跨度最多 12 个自然月；需要更长历史时按窗口分段多次调用。
• 默认不复权（none），forward 前复权、backward 后复权（取值大小写不敏感）。
• 该接口不校验证券类别；查 ETF 推荐用 etf-candlesticks、查指数用 index-candlesticks、查可转债用 convertible-bond-candlesticks。
• 价格字段 JSON 中为字符串以避免精度丢失。