常见问题

使用 StockHubX 过程中的常见问题和解决方法
阅读提示: 本平台为 StockHubX(StockHubX 行情数据服务)。
  • 速率限制:已支持按 API Key 限频(默认 1200 次/分钟,可配置),超限返回 429 RATE_LIMITEDRetry-After 头。
  • 文中涉及计费、订阅、权限分级的内容为后续规划,当前为统一 API Key 模式。
  • 分钟 K 线:5m/15m/30m/60m 自 2026-01-05 起,1m 自 2026-06-22 起;更早的 1m 历史为可选采购项(见数据范围与路线图)。
  • Python SDK:官方 tickflow SDK 直接可用,TickFlow(api_key=..., base_url="https://api.stock.szyijia.cn")
  • 接口协议与错误码与本文档描述一致。

K 线数据

klines.get() 默认返回最近 100 根 K 线。如需更多数据,请显式设置 count 参数:
也可以通过 start_timeend_time 指定时间范围来获取数据。
StockHubX 支持 5 种复权方式,通过 adjust 参数指定:
东方财富、同花顺等软件默认使用的是差值前复权(加减法),对应 adjust="forward_additive"StockHubX 的默认值 "forward" 是比例前复权(乘除法),两者结果不同。如需与这些软件的价格对齐,请使用 "forward_additive"
比例 vs 差值的区别:比例复权保持涨跌幅不变(适合收益率计算),差值复权保持价差不变(适合与行情软件对比价格)。如需查看除权因子:
付费订阅一般不会触发频率限制。如果遇到,大概率是用法问题——逐只标的循环调用单只接口会产生大量请求。推荐使用批量接口,一次请求获取多只标的的数据:
日内分钟线同理:

行情数据

标的代码

使用标的池接口查看:
格式为 代码.市场后缀(英文点号分隔),后缀必须大写。

连接问题

可在 GET /health 接口检查服务状态。
如果在使用 StockHubX API 时遇到连接超时(timeout)、连接被拒绝(connection refused)等问题:当前提供统一接入点 https://docs.stock.szyijia.cn
如何选择最优端点?当前提供统一接入点,无需选择端点。确定端点后如何切换?

WebSocket 实时行情

WebSocket 实时行情是独立的付费功能,需要:
  • 订阅 Expert 套餐(已包含 WebSocket 实时行情),或
  • 自定义套餐中单独开启「WebSocket 实时行情」功能
每个连接的最大订阅标的数由套餐决定(Expert 默认 100 个标的)。
  • 401:API Key 无效或过期,请检查 Key 是否正确
  • 403:当前套餐不包含 WebSocket 实时行情功能,需升级套餐
遇到 401/403 时不应自动重连,请先检查 API Key 和套餐权限。
不会。连接断开后服务端自动清除该连接的所有订阅。重连后需要重新发送 subscribe 恢复订阅。使用 Python SDK 时,SDK 会自动处理断线重连和订阅恢复。