US 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
代码格式	Ticker 符号（如 AAPL）
日期格式	YYYYMMDD

---

端点详情

GET /api/v2/usstock/stocks

Parameter	Type	Required	Description	Example
symbol	string	Yes	Ticker 符号	AAPL
startDate	string	No	YYYYMMDD	20240101
endDate	string	No	YYYYMMDD	20240131
limit	int	No	1-5000 (默认 100)	500

---

调用示例

# 最近100根日线（默认）
curl -sS "${AUTH[@]}" "$BASE/api/v2/usstock/stocks?symbol=AAPL"

# 指定区间
curl -sS "${AUTH[@]}" "$BASE/api/v2/usstock/stocks?symbol=AAPL&startDate=20240101&endDate=20240131"

# 指定数量
curl -sS "${AUTH[@]}" "$BASE/api/v2/usstock/stocks?symbol=TSLA&limit=200"

# 多股票K线并行
curl -sS "${AUTH[@]}" "$BASE/api/v2/usstock/stocks?symbol=AAPL&limit=10" &
curl -sS "${AUTH[@]}" "$BASE/api/v2/usstock/stocks?symbol=TSLA&limit=10" &
wait

---

错误排查

错误	原因	修复
404	Ticker 符号错误	检查大小写和拼写
空数据	日期区间无交易日	检查日期范围
400	日期格式错误	用 YYYYMMDD