导语:行情接口通常分两条路:一条给你某个时刻的完整订单簿(snapshot),一条只推变化的那几档(diff)。做市与风控系统都在本地把两者拼成一本账。规则不复杂,但长期不漂移的实现不多——因为账本坏了不会报错,它只会安静地偏离真实市场,直到你的报价被人吃掉。
一、拼接的三条不变量
本地簿 = 快照 + 快照之后全部增量之和。要让这条式子成立,必须同时满足三件事:不重不漏(每条增量恰好被应用一次);档位一致(增量价格落在已有档位上,数量为 0 即删除该档);时点连续(第一条被采纳的增量,其序号区间与快照衔接)。
第三条最容易被忽略。快照是服务器在某个瞬间生成的,带一个序号;增量流是连续的。如果两者隔了 300 毫秒,那段时间的变化既不在快照里,也不在你接上的增量里——账本从一开始就缺了几档,而程序并不知道。
二、一次连接的生命周期
标准做法四步。取快照并记下最后一个序号(不同交易所叫 lastUpdateId、sequence 或 seqId);连上推送流后,把结束序号小于等于快照序号的增量全部丢弃;找到第一条「跨过」快照序号的增量,即 U ≤ lastUpdateId + 1 ≤ u;此后每一条都必须与前一条首尾相接,也就是 prevSeqId 等于上一条的 seqId。
判据写成 U ≤ lastUpdateId + 1 ≤ u,三个符号依次是增量的起始序号、快照序号、结束序号。任何一条对不上,正确动作只有重建。
三、三类断点,只有一类会自己报警
第一类丢包:本地消费太慢或服务器限速断开,通常以连接关闭暴露。第二类乱序与重复:重连后序号跳变,或同一批消息被重复投递,没有幂等处理就会把数量算两遍。第三类半原子快照:快照由多个分片拼成,取的过程中市场已经动了,序号衔接得上,档位却对不齐。
第三类没有任何异常信号。唯一能抓到的痕迹是买一价高于卖一价,或某一档数量为负。所以必须加两条不花钱的自检:验证最优买价小于最优卖价、验证所有数量非负。它们证明不了账本对,但能证明账本错了。
四、重建的判据与代价
重建不是「发现异常就重连」。一次重建意味一次快照请求(有权重)、几十到几百毫秒空窗,期间所有信号失效。合理做法是分级:序号不连续立即重建;校验和不匹配立即重建;时钟偏移超阈值先丢弃旧消息再重连;只有一致性自检失败时才允许连续重建,并同时把报价降级。
| 断点类型 | 症状 | 本地判定 | 处理 |
|---|---|---|---|
| 序号跳空 | 档位缺失、价格越层 | prevSeqId 不等于上一条 seqId | 重取快照,不补洞 |
| 快照与流错位 | 找不到第一条有效增量 | U 大于快照序号加一 | 重取快照并重连 |
| 校验和不匹配 | 档位与远端不一致 | 本地重算值与推送值不同 | 全量重同步 |
| 重复投递 | 同一档被加两次 | 序号不大于已应用最大值 | 按序号去重 |
| 半原子快照 | 买一高于卖一 | 一致性自检失败 | 重建并降级报价 |
把这张表当运维清单:每项落到一条日志、一个计数器和一个告警上。行情账本的可靠性,不由你懂不懂公式决定,而由你有没有在第一条消息就把它卡住决定。
五、FAQ
取决于报价深度。算冲击成本通常只需前 20 到 50 档,但档位太少,薄盘时增量会落在快照范围外。取最深挂单距离的一倍作余量;越深,快照权重越高。
问:只订阅增量、不要快照行不行?
不行。增量是相对的,没有基准状态就无从应用。少数交易所把初始快照与后续增量放在同一条流里,本质仍是同一件事。
问:序号断了,能用 REST 补一段历史吗?
多数现货接口不提供按序号回放订单簿。能回放的是逐笔成交,而成交无法还原被撤走的挂单,所以只能重建。
六、来源、访问日期与相关阅读
- Binance Spot API:《How to manage a local order book correctly》,depth 增量与 lastUpdateId 的衔接规则。
- OKX v5 API:books 频道,seqId、prevSeqId 与校验和字段。
- Coinbase Advanced Trade:WebSocket level2 频道的快照与增量序号。
- Kraken WebSocket v2:book 频道的快照、更新与 checksum。
以上来源访问日期均为 2026 年 10 月 28 日。
相关阅读