币安现货API升级-开发者需要注意什么

线上服务还在把所有交易状态写死成固定枚举，升级后突然收到 CANCEL_ONLY，最坏结果不是少展示一行文字，而是状态机抛错、缓存拒绝更新，连带让撤单与风控判断失真。2026 年的币安现货 API 变化，开发者要按兼容性事件处理，而不是只换一份接口文档。

先修枚举，再接新状态

GET /api/v3/exchangeInfo 与 WebSocket API 的 exchangeInfo 已可返回 symbolStatus=CANCEL_ONLY。解析层应保留未知值，业务层再明确此状态允许什么动作。失败场景很直接：反序列化使用封闭枚举时，新值会让整包响应失败，监控却可能只看到“行情为空”。

SBE 3:5 上线，3:4 进入退场期

SBE 3:5 已加入 CANCEL_ONLY，3:4 被标记为弃用并按六个月策略退役。迁移时可让消费者同时识别两版 schema，记录每版流量与解码错误，再逐步切换。失败场景是生产端先发 3:5、消费端仍按 3:4 解码，字段错位会比显式报错更危险。

官方 7 月 17 日更新还预告：2026 年 8 月 4 日约 07:00 UTC，部分 SBE 深度流与 FIX SBE 增量深度的更新间隔将从 25ms 调整为 20ms。容量评估应重算每秒消息数、队列水位和落盘压力；只看平均吞吐，突发时就可能积压。

断线恢复要从“异常”改成常规路径

WebSocket 基础设施升级可能主动断开连接，serverShutdown 事件也用于提示服务端即将关闭。客户端应有指数退避、随机抖动、订阅恢复、序列校验与快照补洞。失败场景是只写自动重连却不恢复订阅，连接显示在线，订单簿实际上已经停止更新。

把上半年的兼容账一次补齐

• 旧的 /api/v1/* 端点已经退役，启动时扫描配置与代码常量；失败时不要无限重试已不存在的路径。
• 用户数据流的 listenKey REST 管理方式已退役，迁移到当前文档指定的订阅机制；否则心跳正常也拿不到用户事件。
• 签名请求应先按规则完成百分号编码，再计算签名；顺序反了会得到 -1022，重试只会继续消耗限额。
• 订单接口的成功请求权重与失败请求计费方式可能不同，限流器要读取真实响应头；把所有失败当免费会在故障时触发二次限流。

上线前留一条可回滚的线

在测试环境回放 exchangeInfo、深度流、订单查询和用户事件样本，故意注入未知枚举、旧 schema、断线、乱序与签名错误；监控至少覆盖解码失败、序列缺口、重连次数、限流响应和订阅恢复耗时。版本切换保留开关与双读窗口，确认数据一致后再删旧逻辑。API 升级真正要守住的，是遇到新值和短暂中断时系统仍能降级，而不是把一次通过测试当成永久兼容。