hk-kline

name	hk-kline
description	港股K线数据查询。获取日线、周线、月线行情。 当用户询问"腾讯日K""港股K线""港交所周线""恒指月线"时触发。
user-invocable	true
metadata	{"openclaw":"1.0.0","emoji":"🇭🇰","install":"# OpenClaw\n\ncp -r skills/hk-kline ~/.openclaw/skills/\n"}

HK Kline — 港股K线数据

所有接口均为 V2 版本（/api/v2/...）。

Curl Setup

BASE="http://43.167.234.49:3101"
AUTH=(-H "X-API-Key: 123456" -H "Content-Type: application/json")

---

代码格式规则

规则	值
参数名	symbol
代码格式	带 .HK 后缀
日期格式	YYYYMMDD

示例	说明
00700.HK	腾讯控股
09988.HK	阿里巴巴

❌ 错误写法：00700（纯数字）

---

⚠️ 已知问题：limit 参数不返回最新数据

/api/v2/hkstock/stocks 的 limit 可能不包含最新交易日。必须用 startDate + endDate 代替 limit。

---

端点详情

GET /api/v2/hkstock/stocks

Parameter	Type	Required	Description	Example
symbol	string	Yes	股票代码（带 .HK）	00700.HK
startDate	string	推荐	YYYYMMDD	20260301
endDate	string	推荐	YYYYMMDD	20260405
limit	int	不推荐	有 bug，可能缺少最新数据	—

---

调用示例

# ✅ 推荐：用日期范围
curl -sS "${AUTH[@]}" "$BASE/api/v2/hkstock/stocks?symbol=00700.HK&startDate=20260301&endDate=20260405"

# ❌ 不推荐：用 limit（可能缺少最新数据）
curl -sS "${AUTH[@]}" "$BASE/api/v2/hkstock/stocks?symbol=00700.HK&limit=10"

# 多股票K线并行
curl -sS "${AUTH[@]}" "$BASE/api/v2/hkstock/stocks?symbol=00700.HK&startDate=20260301&endDate=20260405" &
curl -sS "${AUTH[@]}" "$BASE/api/v2/hkstock/stocks?symbol=09988.HK&startDate=20260301&endDate=20260405" &
wait

---

错误排查

错误	原因	修复
404	symbol 格式错误	用 00700.HK，不要 00700
最新数据缺失	使用了 limit	改用 startDate + endDate
400	日期格式错误	用 YYYYMMDD

---

端点黑名单

❌ 不存在的端点	✅ 替代方案
/api/v2/hkstock/daily	/api/v2/hkstock/stocks（参数名 symbol）