etf-candlesticks

Name: etf-candlesticks
Author: FTShare-Lab

17stars2forks

How to install etf-candlesticks?

ftshare-lab/ftshare-skills/etf-candlesticks

$npx -y skills add FTShare-Lab/FTShare-skills --skill etf-candlesticks

Installs into the current project.

Summary

单只 ETF 历史 K 线 POST 接口（market.ft.tech，etf-candlesticks）。用户问某只 ETF 的分/日/周/月/年 K 线、开高低收、前/后复权、分钟级 K 线、5 分钟/日 K/周 K/月 K/年 K 时使用。必填 --symbol、--interval-unit、--until-ts-millis；可选 --interval-value、--adjust-kind、--since-ts-millis、--limit。

Files · 1

View on GitHub

SKILL.md

1	# ETF K 线 - 查询单只 ETF 历史 K 线（etf-candlesticks）
2
3	## 1. 接口描述
4
5	\| 项目 \| 说明 \|
6	\|------\|------\|
7	\| 接口名称 \| 查询单只 ETF 历史 K 线 \|
8	\| 外部接口 \| `POST /api/v1/market/data/etf-candlesticks` \|
9	\| 请求方式 \| POST（JSON body） \|
10	\| 适用场景 \| 获取指定 ETF 的分/日/周/月/年 K 线，含开高低收、成交量、成交额；支持前复权 / 后复权 / 不复权。仅接受 ETF 标的 \|
11
12	> 与 `etf-ohlcs`（`GET daec/history/ohlcs`，YYYYMMDD 日期区间，仅日/周/月）区别：本接口走 POST + JSON body，参数为毫秒时间戳，支持分钟级与年 K，是统一的 candlesticks 契约。
13
14	## 2. 请求参数
15
16	\| 参数名 \| 类型 \| 是否必填 \| 描述 \| 取值示例 \| 备注 \|
17	\|--------\|------\|----------\|------\|----------\|------\|
18	\| symbol \| string \| 是 \| ETF 代码（带市场后缀） \| 510300.XSHG、159915.XSHE \| 也接受 `.SH`/`.SZ` 短后缀；非 ETF 标的当前返回系统错误 \|
19	\| interval_unit \| string \| 是 \| 周期单位 \| Day \| Minute/Day/Week/Month/Year \|
20	\| interval_value \| int \| 否 \| 间隔数值 \| 1 \| 默认 1；Minute+5 表示 5 分钟 K 线 \|
21	\| adjust_kind \| string \| 否 \| 复权类型 \| Forward \| None（默认）/Forward（前复权）/Backward（后复权） \|
22	\| since_ts_millis \| int \| 否 \| 开始时间戳（毫秒） \| 1756700000000 \| 分钟 K 线与 until 跨度 ≤3 天，其余周期不受 3 天限制 \|
23	\| until_ts_millis \| int \| 是 \| 结束时间戳（毫秒） \| 1756791000000 \| - \|
24	\| limit \| int \| 否 \| 返回条数上限 \| 5 \| 未传 since 和 limit 时默认最多返回 50 根 \|
25
26	## 3. 响应说明
27
28	返回裸数组，每根 K 线包含：
29
30	\| 字段名 \| 类型 \| 说明 \| 单位 \|
31	\|--------\|------\|------\|------\|
32	\| open \| string \| 开盘价 \| 元 \|
33	\| high \| string \| 最高价 \| 元 \|
34	\| low \| string \| 最低价 \| 元 \|
35	\| close \| string \| 收盘价（或最新价） \| 元 \|
36	\| ts_millis \| int \| 收盘时间戳 \| 毫秒 \|
37	\| ts_millis_open \| int \| 开盘时间戳 \| 毫秒 \|
38	\| turnover \| string \| 成交额 \| 元 \|
39	\| volume \| int64 \| 成交量 \| 份 \|
40
41	## 4. 调用方式
42
43	通过主目录 `run.py` 调用：
44
45	```bash
46	python <RUN_PY> etf-candlesticks --symbol 510300.XSHG --interval-unit Day --until-ts-millis 1756791000000 --limit 5
47	python <RUN_PY> etf-candlesticks --symbol 510300.XSHG --interval-unit Minute --interval-value 5 --adjust-kind Forward --since-ts-millis 1756700000000 --until-ts-millis 1756791000000 --limit 100
48	```
49
50	`<RUN_PY>` 为主 SKILL.md 同级 `run.py` 的绝对路径。输出 JSON，请求头已内置 `X-Client-Name: ft-claw`。
51
52	### 直接执行 handler（调试）
53
54	```bash
55	python scripts/handler.py --symbol 510300.XSHG --interval-unit Day --until-ts-millis 1756791000000 --limit 5
56	```
57
58	## 5. 注意事项
59
60	- `symbol`、`interval_unit`、`until_ts_millis` 必填。
61	- `symbol` 必须是 ETF 代码，格式 `{代码}.{市场}`；非 ETF 标的当前外部接口返回系统错误。
62	- 分钟 K 线（`interval_unit=Minute`）的 `since/until` 跨度硬限制 ≤3 天，超过需分段调用。
63	- `interval_value` 仅在 `interval_unit=Minute` 时生效：不传或传 1 为 1 分钟 K，传 5/15/30/60/120 为对应多分钟 K；其他周期忽略该字段。
64	- 多分钟 K 按北京时间的每个交易日分别聚合，不跨交易日；以 5 分钟 K 为例，首根为 09:30—09:35，开高低收取区间首根开盘价、最高价、最低价、末根收盘价，成交量和成交额按区间求和。
65	- 默认不复权（None），`Forward` 前复权、`Backward` 后复权。
66	- 价格字段 JSON 中为字符串以避免精度丢失。

People who liked this also viewed

6 picks

Type

etf-candlesticks

17stars2forks

View on GitHub

How to install etf-candlesticks?

ftshare-lab/ftshare-skills/etf-candlesticks

$npx -y skills add FTShare-Lab/FTShare-skills --skill etf-candlesticks

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# ETF K 线 - 查询单只 ETF 历史 K 线（etf-candlesticks）
2
3	## 1. 接口描述
4
5	\| 项目 \| 说明 \|
6	\|------\|------\|
7	\| 接口名称 \| 查询单只 ETF 历史 K 线 \|
8	\| 外部接口 \| `POST /api/v1/market/data/etf-candlesticks` \|
9	\| 请求方式 \| POST（JSON body） \|
10	\| 适用场景 \| 获取指定 ETF 的分/日/周/月/年 K 线，含开高低收、成交量、成交额；支持前复权 / 后复权 / 不复权。仅接受 ETF 标的 \|
11
12	> 与 `etf-ohlcs`（`GET daec/history/ohlcs`，YYYYMMDD 日期区间，仅日/周/月）区别：本接口走 POST + JSON body，参数为毫秒时间戳，支持分钟级与年 K，是统一的 candlesticks 契约。
13
14	## 2. 请求参数
15
16	\| 参数名 \| 类型 \| 是否必填 \| 描述 \| 取值示例 \| 备注 \|
17	\|--------\|------\|----------\|------\|----------\|------\|
18	\| symbol \| string \| 是 \| ETF 代码（带市场后缀） \| 510300.XSHG、159915.XSHE \| 也接受 `.SH`/`.SZ` 短后缀；非 ETF 标的当前返回系统错误 \|
19	\| interval_unit \| string \| 是 \| 周期单位 \| Day \| Minute/Day/Week/Month/Year \|
20	\| interval_value \| int \| 否 \| 间隔数值 \| 1 \| 默认 1；Minute+5 表示 5 分钟 K 线 \|
21	\| adjust_kind \| string \| 否 \| 复权类型 \| Forward \| None（默认）/Forward（前复权）/Backward（后复权） \|
22	\| since_ts_millis \| int \| 否 \| 开始时间戳（毫秒） \| 1756700000000 \| 分钟 K 线与 until 跨度 ≤3 天，其余周期不受 3 天限制 \|
23	\| until_ts_millis \| int \| 是 \| 结束时间戳（毫秒） \| 1756791000000 \| - \|
24	\| limit \| int \| 否 \| 返回条数上限 \| 5 \| 未传 since 和 limit 时默认最多返回 50 根 \|
25
26	## 3. 响应说明
27
28	返回裸数组，每根 K 线包含：
29
30	\| 字段名 \| 类型 \| 说明 \| 单位 \|
31	\|--------\|------\|------\|------\|
32	\| open \| string \| 开盘价 \| 元 \|
33	\| high \| string \| 最高价 \| 元 \|
34	\| low \| string \| 最低价 \| 元 \|
35	\| close \| string \| 收盘价（或最新价） \| 元 \|
36	\| ts_millis \| int \| 收盘时间戳 \| 毫秒 \|
37	\| ts_millis_open \| int \| 开盘时间戳 \| 毫秒 \|
38	\| turnover \| string \| 成交额 \| 元 \|
39	\| volume \| int64 \| 成交量 \| 份 \|
40
41	## 4. 调用方式
42
43	通过主目录 `run.py` 调用：
44
45	```bash
46	python <RUN_PY> etf-candlesticks --symbol 510300.XSHG --interval-unit Day --until-ts-millis 1756791000000 --limit 5
47	python <RUN_PY> etf-candlesticks --symbol 510300.XSHG --interval-unit Minute --interval-value 5 --adjust-kind Forward --since-ts-millis 1756700000000 --until-ts-millis 1756791000000 --limit 100
48	```
49
50	`<RUN_PY>` 为主 SKILL.md 同级 `run.py` 的绝对路径。输出 JSON，请求头已内置 `X-Client-Name: ft-claw`。
51
52	### 直接执行 handler（调试）
53
54	```bash
55	python scripts/handler.py --symbol 510300.XSHG --interval-unit Day --until-ts-millis 1756791000000 --limit 5
56	```
57
58	## 5. 注意事项
59
60	- `symbol`、`interval_unit`、`until_ts_millis` 必填。
61	- `symbol` 必须是 ETF 代码，格式 `{代码}.{市场}`；非 ETF 标的当前外部接口返回系统错误。
62	- 分钟 K 线（`interval_unit=Minute`）的 `since/until` 跨度硬限制 ≤3 天，超过需分段调用。
63	- `interval_value` 仅在 `interval_unit=Minute` 时生效：不传或传 1 为 1 分钟 K，传 5/15/30/60/120 为对应多分钟 K；其他周期忽略该字段。
64	- 多分钟 K 按北京时间的每个交易日分别聚合，不跨交易日；以 5 分钟 K 为例，首根为 09:30—09:35，开高低收取区间首根开盘价、最高价、最低价、末根收盘价，成交量和成交额按区间求和。
65	- 默认不复权（None），`Forward` 前复权、`Backward` 后复权。
66	- 价格字段 JSON 中为字符串以避免精度丢失。

People who liked this also viewed

6 picks

Type