undermybelt 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） |