Stock ohlcs

查询单只股票 OHLC K 线（daec）

接口说明

项目	说明
接口名称	标的K线数据
外部接口	/api/v1/market/data/daec/history/ohlcs
请求方式	GET
适用场景	获取 A 股指定标的在指定日期区间、周期的 K 线；支持 compat=v2 返回旧 v2 风格结构和均线字段

已从旧 v2 路径迁移至 daec 统一标的接口（daec/history/ohlcs?symbol=）。原始模式使用 --since/--until + --interval + --adjust；--compat v2 可使用 --span/--limit/--until_ts_ms 并返回 ma5/ma10/ma20/prev_close 等兼容字段。当前 daec 兼容模式不支持 YEAR1。

请求参数

说明：推荐使用 --symbol；仍兼容旧参数 --stock。原始模式至少需要 --since，--until 不传时脚本默认今天；compat=v2 模式可不传日期区间。

参数名	类型	是否必填	描述	取值示例	备注
symbol	string	是	标的代码（带市场后缀）	600000.XSHG	沪 .XSHG、深 .SZ、北交所 .BJ
stock	string	否	symbol 的旧别名	600000.XSHG	仅为兼容旧调用方式
since	string	原始模式是	起始日期 YYYYMMDD	20240101	v2 兼容模式可不传
until	string	否	结束日期 YYYYMMDD	20240131	原始模式不传则默认今天
interval	string	否	原始模式 K 线周期	Day	Minute、Day（日线，默认）、Week、Month；无年线
adjust	string	否	复权类型	Forward	Forward（前复权，默认）、Backward（后复权）、None（不复权）
compat	string	否	兼容模式	v2	传 v2 时启用旧 v2 响应结构
span	string	否	v2 兼容模式 K 线周期	DAY1	DAY1、WEEK1、MONTH1；不支持 YEAR1
limit	int	否	v2 兼容模式返回最近 N 根 K 线	5	-
until_ts_ms	int	否	v2 兼容模式截止毫秒时间戳	1782748799999	服务端按北京时间转换为截止日期

执行方式

通过根目录的 run.py 调用（推荐）：

# 600000.XSHG 2024-01 的日线
python <RUN_PY> stock-ohlcs --symbol 600000.XSHG --since 20240101 --until 20240131

# 周线
python <RUN_PY> stock-ohlcs --symbol 600000.XSHG --since 20240101 --until 20260628 --interval Week

# 前复权月线（until 默认今天）
python <RUN_PY> stock-ohlcs --symbol 600000.XSHG --since 20230101 --interval Month --adjust Forward

# v2 兼容模式：最近 5 根日 K，直接输出服务端兼容对象
python <RUN_PY> stock-ohlcs --symbol 600000.XSHG --compat v2 --span DAY1 --limit 5

# 旧参数仍可使用
python <RUN_PY> stock-ohlcs --stock 600000.XSHG --since 20240101 --until 20240131

<RUN_PY> 为主 SKILL.md 同级的 run.py 绝对路径，参见主 SKILL.md 的「调用方式」说明。

响应结构

原始模式返回 K 线列表，包装为 {"ohlcs": [...]}（daec 返回裸数组，脚本统一包装）：

{
    "ohlcs": [
        { "open": "8.30", "high": "8.33", "low": "8.19", "close": "8.28", "volume": 60213694, "turnover": "496075055.52", "open_ts_ms": "2024-06-03T09:30:00", "close_ts_ms": "2024-06-03T15:00:00" }
    ]
}

Ohlc 单条结构（ohlcs 元素）

字段名	类型	是否可为空	说明	单位
open	string	否	开盘价	元
high	string	否	最高价	元
low	string	否	最低价	元
close	string	否	收盘价	元
volume	long	否	成交量	股
turnover	string	否	成交额	元
open_ts_ms	string	否	该根 K 线开始时间（北京时间 ISO）	-
close_ts_ms	string	否	该根 K 线结束时间（北京时间 ISO）	-

compat=v2 模式直接输出服务端对象：

{
  "current_time": "2026-06-29T15:03:10.123456789+08:00",
  "has_last_empty": false,
  "prev_close": 9.16,
  "ohlcs": [
    {"o": 8.80, "h": 8.90, "l": 8.70, "c": 8.75, "v": 68098356, "t": 588719704.13, "otm": 1782662400000, "ctm": 1782748799999}
  ],
  "ma5": [{"p": null, "ctm": 1782748799999}],
  "ma10": [{"p": null, "ctm": 1782748799999}],
  "ma20": [{"p": null, "ctm": 1782748799999}]
}

注：原始模式价格字段为字符串类型（避免浮点精度丢失）；compat=v2 模式的字段名和类型按服务端兼容对象输出。

注意事项

• symbol 为必填；旧 stock 参数仍可作为别名使用。
• 原始模式需要 since；since/until 需为 YYYYMMDD（8 位数字）。
• 股票代码需携带市场后缀：沪市 .XSHG、深市 .SZ、北交所 .BJ
• interval 支持 Minute/Day/Week/Month（daec 无年线）；不传默认 Day。
• compat=v2 的 span 支持 DAY1/WEEK1/MONTH1，不支持 YEAR1。
• adjust 可选 Forward/Backward/None，默认 Forward（前复权）；None 为不复权。
• 所有接口请求需携带 X-Client-Name: ft-claw 请求头
• 原始模式下，脚本将每条 open_ts_ms/close_ts_ms（毫秒）转为北京时间 ISO 字符串；compat=v2 保留服务端返回字段。
• 已知问题：daec 大区间响应（如多年日线，~100KB+）服务端偶发传输中断（IncompleteRead），脚本内置 5 次指数退避重试；如仍失败会非零退出。建议按需缩小日期区间