--- name: stock-ohlcs description: "标的K线数据。当用户需要获取 A 股指定标的在指定日期区间、周期的 K 线；支持 `compat=v2` 返回旧 v2 风格结构和均线字段，或了解单只股票 OHLC K 线（daec）、标的K线数据时使用。" --- # 查询单只股票 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` 调用（推荐）： ```bash # 600000.XSHG 2024-01 的日线 python stock-ohlcs --symbol 600000.XSHG --since 20240101 --until 20240131 # 周线 python stock-ohlcs --symbol 600000.XSHG --since 20240101 --until 20260628 --interval Week # 前复权月线（until 默认今天） python stock-ohlcs --symbol 600000.XSHG --since 20230101 --interval Month --adjust Forward # v2 兼容模式：最近 5 根日 K，直接输出服务端兼容对象 python stock-ohlcs --symbol 600000.XSHG --compat v2 --span DAY1 --limit 5 # 旧参数仍可使用 python stock-ohlcs --stock 600000.XSHG --since 20240101 --until 20240131 ``` > `` 为主 `SKILL.md` 同级的 `run.py` 绝对路径，参见主 SKILL.md 的「调用方式」说明。 ## 响应结构 原始模式返回 K 线列表，包装为 `{"ohlcs": [...]}`（daec 返回裸数组，脚本统一包装）： ```json { "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` 模式直接输出服务端对象： ```json { "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 次指数退避重试；如仍失败会非零退出。建议按需缩小日期区间