- name
- daec-ohlcs
- description
- 按标的和日期区间查询历史 OHLC K 线(DAEC)。用户提到「DAEC 历史 OHLC」「DAEC K 线」「daec ohlcs」时使用。标准模式返回 K 线数组;传入 compat=v2 返回兼容版结构,并附带前收盘价和 MA5/MA10/MA20。标准模式 since/until 必填,YYYYMMDD。
# 查询 DAEC 历史 OHLC
## 接口说明
| 项目 | 说明 |
|------|------|
| 接口名称 | 查询 DAEC 历史 OHLC |
| 外部接口 | GET /api/v1/market/data/daec/history/ohlcs |
| 请求方式 | GET |
| 适用场景 | 按标的和日期区间查询历史 OHLC K 线;兼容模式可供旧前端直接消费 |
## 请求参数
| 参数名 | 类型 | 是否必填 | 描述 | 取值示例 | 备注 |
|--------|------|----------|------|----------|------|
| symbol | string | 是 | 标的代码 | `600000.XSHG` | - |
| since | string | 标准模式必填 | 起始日期 | `20260701` | YYYYMMDD |
| until | string | 标准模式必填 | 结束日期 | `20260731` | YYYYMMDD |
| interval | string | 否 | 周期 | `Day` | `Minute`/`Day`/`Week`/`Month`,默认 `Day` |
| adjust | string | 否 | 复权 | `Forward` | `None`/`Forward`/`Backward` |
| compat | string | 否 | 兼容版开关 | `v2` | 传 `v2` 启用兼容版响应 |
| span | string | 否 | 兼容模式周期 | `DAY1` | `DAY1`/`WEEK1`/`MONTH1`,默认 `DAY1` |
| limit | int | 否 | 兼容模式返回数量 | `250` | 默认 250 |
| until_ts_ms | int64 | 否 | 兼容模式结束时间戳 | `1785488400000` | 毫秒;优先于默认当前日期 |
## 执行方式
```bash
# 标准模式
python <RUN_PY> daec-ohlcs --symbol 600000.XSHG --since 20260701 --until 20260731 --interval Day --adjust Forward
# 兼容 v2 模式
python <RUN_PY> daec-ohlcs --symbol 600000.XSHG --compat v2 --span DAY1 --limit 250
```
`<RUN_PY>` 为主 SKILL.md 同级的 `run.py` 绝对路径。
## 响应结构
外层 `code/message/data`。
### 标准模式
`data` 直接为数组,每项字段:
| 字段 | 类型 | 说明 |
|------|------|------|
| open_ts_ms / close_ts_ms | int64 | K 线开始 / 结束时间(毫秒) |
| open / high / low / close | string | 开高低收 |
| volume | int64 | 成交量 |
| turnover | string | 成交额 |
```json
{
"code": 200,
"message": "success",
"data": [
{
"close_ts_ms": 1785488400000, "close": "10.25", "high": "10.36",
"low": "10.08", "open": "10.12", "open_ts_ms": 1785461400000,
"turnover": "126530000.00", "volume": 12345678
}
]
}
```
### 兼容模式(compat=v2)
`data` 为对象,含 `current_time`/`has_last_empty`/`prev_close`/`ohlcs`/`ma5`/`ma10`/`ma20`。其中 `ohlcs` 使用缩写字段 `o/h/l/c/v/t/otm/ctm`。
## 注意事项
- 标准模式下 `since`/`until` 必填,格式 YYYYMMDD。
- 兼容模式默认 `limit=250`,`until_ts_ms` 优先于默认当前日期。
- 标准模式字段以字符串返回,`volume` 为 int64。
View on GitHub