开始之前

获取 API Key 和配置服务器地址，选择 SDK 或 API接入

服务模式

当前 StockHubX 提供统一 API 服务，所有接口通过 x-api-key 请求头认证：

当前能力：

✅ A 股 / ETF / 转债 / 指数：日K（2026-01-05 起）、分钟K、实时行情、五档盘口
✅ 分钟 K 线：5m/15m/30m/60m 自 2026-01-05 起；1m 自 2026-06-22 起
✅ 财务数据（利润表/资产负债/现金流/核心指标/股本）、除权因子（1990 起）、复权
✅ WebSocket 实时推送（行情 + 五档）

后续计划（详见数据范围与路线图）：

美股 / 港股行情
按订阅分级的限流配额

步骤一：获取 API Key

当前通过控制台 API 或服务管理员分配 API Key：

# 注册账户（后续计划：自助门户页面）
curl -X POST https://api.stock.szyijia.cn/api/auth/register \
  -H "Content-Type: application/json" \
  -d '{"username": "your-name", "password": "your-password"}'

# 登录后在控制台 API 创建 Key
# POST /api/auth/login -> JWT -> POST /api/keys

步骤 2：服务器地址

https://docs.stock.szyijia.cn

WebSocket 推送地址：

wss://api.stock.szyijia.cn/v1/ws/stream?api_key=your-api-key

快速开始

Python SDK

5 分钟上手 StockHubX Python SDK

HTTP API

3 分钟上手 StockHubX API