소스 정보
- 저장소
- FTShare-Lab/FTShare-skills
- 최근 소스 활동
- 2026년 7월 3일 09:05
- 감지된 SKILL.md 언어
- 중국어
- 스타
- 46
- 포크
- 7
설치 방법
기본적으로 소스를 먼저 확인하는 Prompt가 선택됩니다. 직접 명령으로 전환하거나 로컬 사본을 다운로드할 수도 있습니다.
소스 파일 검토
설치 여부를 결정하기 전에 SKILL.md와 SkillsMP에 표시된 보조 파일을 읽어 보세요.
파일 탐색기
3 개 파일SKILL.md 표시 중
SKILL.md
소스 지침 · 읽기 전용 미리보기- name
- index-ohlcs
- description
- 单只指数 OHLC K 线（market.ft.tech）。用户问某只指数的 K 线、日线/周线/月线、开高低收、前/后复权时使用。
# 指数 K 线 - 查询单只指数 OHLC K 线（daec，日期区间）
## 1. 接口描述
| 项目 | 说明 |
|------|------|
| 接口名称 | 查询单只指数 OHLC K 线 |
| 外部接口 | `GET /api/v1/market/data/daec/history/ohlcs` |
| 请求方式 | GET |
| 适用场景 | 获取 A 股指定指数在指定日期区间、周期的 K 线（开高低收、成交量、成交额），支持日/周/月线与前/后复权 |
> 已从 v2（`/app/api/v2/indices/:index/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. 请求参数
说明：`index` 为路径参数（必填），`since` 必填，`until`/`interval`/`adjust` 可选。
| 参数名 | 类型 | 是否必填 | 描述 | 取值示例 | 备注 |
|--------|------|----------|------|----------|------|
| index | string | 是 | 指数标的键（路径参数，带市场后缀） | 000001.XSHG、399001.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. 响应说明
返回指定指数的 K 线列表，包装为 `{"ohlcs": [...]}`（daec 返回裸数组，脚本统一包装）：
```json
{
"ohlcs": [
{ "open": "4067.1578", "high": "4093.0405", "low": "4045.6898", "close": "4057.74", "volume": 67602580600, "turnover": "1319801913950.9", "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） | - |
> 注：daec 接口不再返回 `prev_close`、`MA5/MA10/MA20`、`has_last_empty`；价格字段为字符串类型（避免浮点精度丢失）。
## 4. 用法
通过主目录 `run.py` 调用（必填 `--index`、`--since`）：
```bash
python <RUN_PY> index-ohlcs --index 000001.XSHG --since 20240101 --until 20240131
python <RUN_PY> index-ohlcs --index 399001.XSHE --since 20240101 --until 20260628 --interval Week
python <RUN_PY> index-ohlcs --index 000001.XSHG --since 20230101 --interval Month --adjust Forward
```
或在子 skill 目录下执行：`python scripts/handler.py --index 000001.XSHG --since 20240101 --until 20240131`。脚本输出 JSON，请求头已内置 `X-Client-Name: ft-claw`。
## 5. 注意事项
- `index`、`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 次指数退避重试；如仍失败会非零退出。建议按需缩小日期区间
GitHub에서 보기