etf-ohlcs

Name: etf-ohlcs
Author: FTShare-Lab

17stars2forks

How to install etf-ohlcs?

ftshare-lab/ftshare-skills/etf-ohlcs

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

Installs into the current project.

Summary

单只 ETF OHLC K 线（market.ft.tech）。用户问某只 ETF 的 K 线、日线/周线/月线、开高低收、前/后复权时使用。

Files · 1

View on GitHub

SKILL.md

1	# ETF K 线 - 查询单只 ETF OHLC K 线（daec，日期区间）
2
3	## 1. 接口描述
4
5	\| 项目 \| 说明 \|
6	\|------\|------\|
7	\| 接口名称 \| 查询单只 ETF OHLC K 线 \|
8	\| 外部接口 \| `GET /api/v1/market/data/daec/history/ohlcs` \|
9	\| 请求方式 \| GET \|
10	\| 适用场景 \| 获取 A 股指定 ETF 在指定日期区间、周期的 K 线（开高低收、成交量、成交额），支持日/周/月线与前/后复权 \|
11
12	> 已从 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。
13
14	## 2. 请求参数
15
16	说明：`etf` 为路径参数（必填），`since` 必填，`until`/`interval`/`adjust` 可选。
17
18	\| 参数名 \| 类型 \| 是否必填 \| 描述 \| 取值示例 \| 备注 \|
19	\|--------\|------\|----------\|------\|----------\|------\|
20	\| etf \| string \| 是 \| ETF 标的键（路径参数，带市场后缀） \| 510050.XSHG、159915.XSHE、920036.BJ \| 沪 .XSHG、深 .XSHE、北交所 .BJ \|
21	\| since \| string \| 是 \| 起始日期 YYYYMMDD \| 20240101 \| - \|
22	\| until \| string \| 否 \| 结束日期 YYYYMMDD \| 20240131 \| 不传则默认今天 \|
23	\| interval \| string \| 否 \| K 线周期 \| Day \| Day（日线，默认）、Week（周线）、Month（月线）；无年线 \|
24	\| adjust \| string \| 否 \| 复权类型 \| Forward \| Forward（前复权，默认）、Backward（后复权）、None（不复权） \|
25
26	## 3. 响应说明
27
28	返回指定 ETF 的 K 线列表，包装为 `{"ohlcs": [...]}`（daec 返回裸数组，脚本统一包装）：
29
30	```json
31	{
32	"ohlcs": [
33	{ "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" }
34	]
35	}
36	```
37
38	### Ohlc 单条（ohlcs 元素）
39
40	\| 字段名 \| 类型 \| 是否可为空 \| 说明 \| 单位 \|
41	\|--------\|------\|------------\|------\|------\|
42	\| open \| string \| 否 \| 开盘价 \| 元 \|
43	\| high \| string \| 否 \| 最高价 \| 元 \|
44	\| low \| string \| 否 \| 最低价 \| 元 \|
45	\| close \| string \| 否 \| 收盘价 \| 元 \|
46	\| volume \| long \| 否 \| 成交量 \| 份 \|
47	\| turnover \| string \| 否 \| 成交额 \| 元 \|
48	\| open_ts_ms \| string \| 否 \| 该根 K 线开始时间（北京时间 ISO） \| - \|
49	\| close_ts_ms \| string \| 否 \| 该根 K 线结束时间（北京时间 ISO） \| - \|
50
51	> 注：daec 接口不再返回 `prev_close`、`MA5/MA10/MA20`、`has_last_empty`；价格字段为字符串类型（避免浮点精度丢失）。
52
53	## 4. 用法
54
55	通过主目录 `run.py` 调用（必填 `--etf`、`--since`）：
56
57	```bash
58	python <RUN_PY> etf-ohlcs --etf 510050.XSHG --since 20240101 --until 20240131
59	python <RUN_PY> etf-ohlcs --etf 159915.XSHE --since 20240101 --until 20260628 --interval Week
60	python <RUN_PY> etf-ohlcs --etf 510050.XSHG --since 20230101 --interval Month --adjust Forward
61	```
62
63	`<RUN_PY>` 为主 SKILL.md 同级的 `run.py` 绝对路径。脚本输出 JSON，请求头已内置 `X-Client-Name: ft-claw`。
64
65	## 5. 注意事项
66
67	- `etf`、`since` 为必填；`since`/`until` 需为 YYYYMMDD（8 位数字）
68	- `interval` 仅支持 Day/Week/Month（daec 无年线）；不传默认 Day
69	- `adjust` 可选 Forward/Backward/None，默认 Forward（前复权）；None 为不复权（v2 不支持选复权，daec 为增强）
70	- 执行方式：脚本将每条 `open_ts_ms`/`close_ts_ms`（毫秒）转为北京时间 ISO 字符串（YYYY-MM-DDTHH:mm:ss）
71	- 已知问题：daec 大区间响应（如多年日线，~100KB+）服务端偶发传输中断（IncompleteRead），脚本内置 5 次指数退避重试；如仍失败会非零退出。建议按需缩小日期区间

People who liked this also viewed

6 picks

Type

azure-costAzure cost management: query costs, forecast spending, optimize to reduce waste. WHEN: \"Azure costs\", \"Azure bill\", \"cost breakdown\", \"how much am I spending\", \"forecast spending\", \"optimizSkillsJul 2026275k1.3k
pricingWhen the user wants help with pricing decisions, packaging, or monetization strategy. Also use when the user mentions 'pricing,' 'pricing tiers,' 'freemium,' 'free trial,' 'packaging,' 'price increaseSkillsJul 202638k41k
stripe-integrationMulti-harness agentic plugin marketplace for Claude Code, Codex CLI, Cursor, OpenCode, GitHub Copilot, and Gemini CLISkillsJul 202611k38k
startup-financial-modelingMulti-harness agentic plugin marketplace for Claude Code, Codex CLI, Cursor, OpenCode, GitHub Copilot, and Gemini CLISkillsJul 20269.5k38k
tushare-finance专为 Claude Code 设计的 Tushare Pro 金融数据技能包，支持 220+ 个接口，用自然语言获取 A 股行情、财务数据、宏观经济等金融数据。SkillsJul 20265.0k75
azure-pricingFetches real-time Azure retail pricing using the Azure Retail Prices API (prices.azure.com) and estimates Copilot Studio agent credit consumption. Use when the user asks about the cost of any Azure seSkillsJul 20264.5k37k

etf-ohlcs

17stars2forks

View on GitHub

How to install etf-ohlcs?

ftshare-lab/ftshare-skills/etf-ohlcs

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

Installs into the current project.

Summary

单只 ETF OHLC K 线（market.ft.tech）。用户问某只 ETF 的 K 线、日线/周线/月线、开高低收、前/后复权时使用。

Files · 1

View on GitHub

SKILL.md

1	# ETF K 线 - 查询单只 ETF OHLC K 线（daec，日期区间）
2
3	## 1. 接口描述
4
5	\| 项目 \| 说明 \|
6	\|------\|------\|
7	\| 接口名称 \| 查询单只 ETF OHLC K 线 \|
8	\| 外部接口 \| `GET /api/v1/market/data/daec/history/ohlcs` \|
9	\| 请求方式 \| GET \|
10	\| 适用场景 \| 获取 A 股指定 ETF 在指定日期区间、周期的 K 线（开高低收、成交量、成交额），支持日/周/月线与前/后复权 \|
11
12	> 已从 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。
13
14	## 2. 请求参数
15
16	说明：`etf` 为路径参数（必填），`since` 必填，`until`/`interval`/`adjust` 可选。
17
18	\| 参数名 \| 类型 \| 是否必填 \| 描述 \| 取值示例 \| 备注 \|
19	\|--------\|------\|----------\|------\|----------\|------\|
20	\| etf \| string \| 是 \| ETF 标的键（路径参数，带市场后缀） \| 510050.XSHG、159915.XSHE、920036.BJ \| 沪 .XSHG、深 .XSHE、北交所 .BJ \|
21	\| since \| string \| 是 \| 起始日期 YYYYMMDD \| 20240101 \| - \|
22	\| until \| string \| 否 \| 结束日期 YYYYMMDD \| 20240131 \| 不传则默认今天 \|
23	\| interval \| string \| 否 \| K 线周期 \| Day \| Day（日线，默认）、Week（周线）、Month（月线）；无年线 \|
24	\| adjust \| string \| 否 \| 复权类型 \| Forward \| Forward（前复权，默认）、Backward（后复权）、None（不复权） \|
25
26	## 3. 响应说明
27
28	返回指定 ETF 的 K 线列表，包装为 `{"ohlcs": [...]}`（daec 返回裸数组，脚本统一包装）：
29
30	```json
31	{
32	"ohlcs": [
33	{ "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" }
34	]
35	}
36	```
37
38	### Ohlc 单条（ohlcs 元素）
39
40	\| 字段名 \| 类型 \| 是否可为空 \| 说明 \| 单位 \|
41	\|--------\|------\|------------\|------\|------\|
42	\| open \| string \| 否 \| 开盘价 \| 元 \|
43	\| high \| string \| 否 \| 最高价 \| 元 \|
44	\| low \| string \| 否 \| 最低价 \| 元 \|
45	\| close \| string \| 否 \| 收盘价 \| 元 \|
46	\| volume \| long \| 否 \| 成交量 \| 份 \|
47	\| turnover \| string \| 否 \| 成交额 \| 元 \|
48	\| open_ts_ms \| string \| 否 \| 该根 K 线开始时间（北京时间 ISO） \| - \|
49	\| close_ts_ms \| string \| 否 \| 该根 K 线结束时间（北京时间 ISO） \| - \|
50
51	> 注：daec 接口不再返回 `prev_close`、`MA5/MA10/MA20`、`has_last_empty`；价格字段为字符串类型（避免浮点精度丢失）。
52
53	## 4. 用法
54
55	通过主目录 `run.py` 调用（必填 `--etf`、`--since`）：
56
57	```bash
58	python <RUN_PY> etf-ohlcs --etf 510050.XSHG --since 20240101 --until 20240131
59	python <RUN_PY> etf-ohlcs --etf 159915.XSHE --since 20240101 --until 20260628 --interval Week
60	python <RUN_PY> etf-ohlcs --etf 510050.XSHG --since 20230101 --interval Month --adjust Forward
61	```
62
63	`<RUN_PY>` 为主 SKILL.md 同级的 `run.py` 绝对路径。脚本输出 JSON，请求头已内置 `X-Client-Name: ft-claw`。
64
65	## 5. 注意事项
66
67	- `etf`、`since` 为必填；`since`/`until` 需为 YYYYMMDD（8 位数字）
68	- `interval` 仅支持 Day/Week/Month（daec 无年线）；不传默认 Day
69	- `adjust` 可选 Forward/Backward/None，默认 Forward（前复权）；None 为不复权（v2 不支持选复权，daec 为增强）
70	- 执行方式：脚本将每条 `open_ts_ms`/`close_ts_ms`（毫秒）转为北京时间 ISO 字符串（YYYY-MM-DDTHH:mm:ss）
71	- 已知问题：daec 大区间响应（如多年日线，~100KB+）服务端偶发传输中断（IncompleteRead），脚本内置 5 次指数退避重试；如仍失败会非零退出。建议按需缩小日期区间

People who liked this also viewed

6 picks

Type