Skip to content

频率与配额 ​

订阅额度按当前用户统计,所有连接共享一个订阅池。总额度由账号行情权限决定。不要从其他产品的额度表推算本服务限额。

如何计数 ​

  • 同一标的的 quote、order_book、ticker 是不同订阅项。
  • kline 计入总额度,并按标的、周期 period、复权 adjust 区分订阅项。
  • 同一订阅项跨会话去重;所有会话都不再引用后才释放。由订阅项派生的深度数据不另占额度。
  • 期权订阅同样按具体订阅项计量,与股票等共享一个池;不按期权链聚合,也没有独立期权订阅额度。
  • 历史 K 线的普通池/期权链池与订阅池独立;其规则见行情权限与额度。

例如,同一账号两个连接都订阅 US.AAPL 的 quote,只占一个订阅额度;再订阅同标的 ticker 或不同周期/复权的 K 线会增加使用量。

超限与限频 ​

新增订阅超过额度时,业务订阅响应可返回 code=4:

json
{"id":"sub-001","code":4,"message":"sub quota exceeded, max=..."}

减少当前订阅项或等待额度变化后再重试,不要持续高频重试。订阅/退订控制请求还受当前业务频率策略约束,参见接口限频。

释放与重连 ​

不需要的数据应及时退订。同一账号其他连接仍引用该订阅项时,当前连接退订不会释放账号级额度。异常断连后的会话清理可能延迟;没有固定的立即释放保证。重新连接后需要重新鉴权并恢复订阅,不要复用已失效的会话。

深度与展示 ​

订阅额度不等于行情权限。买卖盘深度、经纪队列和可订阅品类仍由市场权限决定;按实际推送的字段和数组长度展示。逐笔成交按 ticker_list 数组处理,一条消息可能含多笔。批量合并订阅并对重连加入退避,避免短时间重复订退。