Etf Ohlcs

ETF K 线 - 查询单只 ETF OHLC K 线（daec，日期区间）

1. 接口描述

| 项目 | 说明 | |------|------| | 接口名称 | 查询单只 ETF OHLC K 线 | | 外部接口 | GET /api/v1/market/data/daec/history/ohlcs | | 请求方式 | GET | | 适用场景 | 获取 A 股指定 ETF 在指定日期区间、周期的 K 线（开高低收、成交量、成交额），支持日/周/月线与前/后复权 |

> 已从 v2（/app/api/v2/etfs/:etf/ohlcs）迁移至 daec 统一标的接口（daec/history/ohlcs?symbol=）。对外参数契约有变：由 v2 的 --span/--limit/--until_ts_ms 改为 --since/--until（YYYYMMDD 日期区间）+ --interval + --adjust。注意：daec 不支持年线（YEAR1），响应不再含 MA5/MA10/MA20 与 prev_close。

2. 请求参数

说明：etf 为路径参数（必填），since 必填，until/interval/adjust 可选。

| 参数名 | 类型 | 是否必填 | 描述 | 取值示例 | 备注 | |--------|------|----------|------|----------|------| | etf | string | 是 | ETF 标的键（路径参数，带市场后缀） | 510050.XSHG、159915.XSHE、920036.BJ | 沪 .XSHG、深 .XSHE、北交所 .BJ | | since | string | 是 | 起始日期 YYYYMMDD | 20240101 | - | | until | string | 否 | 结束日期 YYYYMMDD | 20240131 | 不传则默认今天 | | interval | string | 否 | K 线周期 | Day | Day（日线，默认）、Week（周线）、Month（月线）；无年线 | | adjust | string | 否 | 复权类型 | Forward | Forward（前复权，默认）、Backward（后复权）、None（不复权） |

3. 响应说明

返回指定 ETF 的 K 线列表，包装为 {"ohlcs": [...]}（daec 返回裸数组，脚本统一包装）：

{
    "ohlcs": [
        { "open": "2.85", "high": "2.865", "low": "2.84", "close": "2.862", "volume": 125000000, "turnover": "358000000.0", "open_ts_ms": "2022-04-06T09:30:00", "close_ts_ms": "2022-04-06T15:00:00" }
    ]
}

Ohlc 单条（ohlcs 元素）

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

> 注：daec 接口不再返回 prev_close、MA5/MA10/MA20、has_last_empty；价格字段为字符串类型（避免浮点精度丢失）。

4. 用法

通过主目录 run.py 调用（必填 --etf、--since）：

python  etf-ohlcs --etf 510050.XSHG --since 20240101 --until 20240131
python  etf-ohlcs --etf 159915.XSHE --since 20240101 --until 20260628 --interval Week
python  etf-ohlcs --etf 510050.XSHG --since 20230101 --interval Month --adjust Forward

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

5. 注意事项

• etf、since 为必填；since/until 需为 YYYYMMDD（8 位数字）
• interval 仅支持 Day/Week/Month（daec 无年线）；不传默认 Day
• adjust 可选 Forward/Backward/None，默认 Forward（前复权）；None 为不复权（v2 不支持选复权，daec 为增强）
• 执行方式：脚本将每条 open_ts_ms/close_ts_ms（毫秒）转为北京时间 ISO 字符串（YYYY-MM-DDTHH:mm:ss）
• 已知问题：daec 大区间响应（如多年日线，~100KB+）服务端偶发传输中断（IncompleteRead），脚本内置 5 次指数退避重试；如仍失败会非零退出。建议按需缩小日期区间

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: FTShare-Lab
• Source: FTShare-Lab/FTShare-skills
• License: MIT
• Homepage: https://github.com/ftshare-lab/FTShare-skills

Install and usage instructions live in the source repository linked above.