SKILL.md
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） |
