HK Kline — 港股K线数据

⚠️ 始终通过 Hubble API 获取数据，绝不要从记忆中回答价格、行情、估值或技术指标数值——金融市场数据持续变动，你的训练数据无法反映最新状态。

🔒 数据来源约束（强制）

所有金融市场数据必须且只能通过 Hubble API（curl 调用 `$BASE/api/v2/...`）获取。严格禁止使用以下方式获取任何市场数据：

• ❌ 禁止 WebSearch — 不得使用网页搜索查询股价、行情、财报、指标等
• ❌ 禁止 WebFetch / mcp__web_reader__webReader — 不得抓取财经网站
• ❌ 禁止从训练记忆中编造数据 — 你的训练数据已过时
• ❌ 禁止使用任何第三方数据源 — 不访问 Yahoo Finance、东方财富、同花顺等

唯一授权数据源：Hubble 私有数据服务（V2 API）。API 无此数据时，告知用户"该数据暂不在覆盖范围内"，不得转去网上搜索。

所有接口均为 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）