摘要： 本文整理币安现货 REST API、WebSocket API、FIX API 截至 2025-07-03 的所有重要更新。涵盖 WebSocket 账户接口升级计划、Order Amend Keep Priority、自成交防止（STP）、Ed25519 密钥、错误码调整、订单权重变化 等高频关键词，助你在改动生效前完成平滑迁移。
一、近期热点：WebSocket 账户接口 7 月升级
升级窗口
- 开始时间：2025-07-08 07:00 UTC
- 预计耗时：≤ 2 小时
- 影响范围：所有 WebSocket 账户接口 连接（包括现货与杠杆）
升级期间，你的应用会 24 小时内随机断线。建议实现 自动重连与退避 机制，保障不停机。
二、高频功能新增与调整
1. Order Amend Keep Priority（保留优先级修改）
- 全面生效时间：2025-05-07
新增端点
- REST：
PUT /api/v3/order/amend/keepPriority - WebSocket：
order.amend.keepPriority
- REST：
- 价值：修改订单 不影响队列优先级，高频量化必备
- 风险提示：当日若频繁调用，IP 与消息频控同时上升，建议做速率保护。
2. STP 新增 DECREMENT 模式
- 功能：当自成交发生时，双边订单同时减量，而非直接撤单
- 场景：网格/跟单策略更灵活
- 必要动作：在
selfTradePreventionMode中新增枚举值DECREMENT
3. Ed25519 API 密钥逐渐开放
- 先用权：目前仅 Ed25519 密钥支持 WebSocket API 订阅账户流
- 扩展计划：2025-Q3 向 HMAC / RSA 密钥开放，官方仍 强烈建议迁移 以享受更低延迟
三、SBE（Simple Binary Encoding）演进
| Schema | 状态 | 停用日期 | 关键差异 |
|---|---|---|---|
| 2.0 → 2.1 | 已弃用 | 2025-12-12 | 仅字段兼容，无新功能 |
| 2.1 → 3.0 | 最新 | 未定 | 支持 Order Amend Keep Priority、DECREMENT、枚举新增 NON_REPRESENTABLE |
- 强制动作：2025-06-12 起，模式 2.0 将被拒绝；请尽快升级至 3.0 并完成回归测试。
四、错误码与权重汇总
2025 年新增常犯错误码
-2039：同时提供orderId与origClientOrderId但查无订单-2038：保留优先级修改失败-2036：做市账户余额不足导致修改被拒绝
权重调整速览
PUT /api/v3/order/amend/keepPriority：权重大幅上调至 4GET /api/v3/myTrades：指定orderId权重 5；未指定仍为 20
五、开发者迁移清单
| 动作 | 截止/生效时间 | 高频依赖端点 | 建议测试网 |
|---|---|---|---|
| WebSocket 账户接口重连脚本 | 2025-07-10 | userDataStream | testnet.binance.vision |
| 升级 SBE 至 3.0 | 2025-06-12 | exchangeInfo | ☑️ |
| 替换 Ed25519 密钥 | 2025-Q3 | 全部 | ☑️ |
| 加入 DECREMENT STP 枚举 | 已可上线 | 下单类 | ☑️ |
六、常见疑问（FAQ）
Q1：7 月升级时我需要做什么？
保持应用具备 指数退避重连，并做好 session identifier 持久化，避免数据重复推送。
Q2：Ed25519 密钥迁移动作量有多大？
只需替换 签名算法 与 headers 计算逻辑，其余字段兼容性不变。官方 SDK 已内置支持。
Q3：DECREMENT 是否会改变现有 STP 枚举顺序？
不会；新增值 在尾部追加 即可，版本 3.0 架构已预留 NON_REPRESENTABLE 以防未来再扩。
Q4：SBE 3.0 是否向下兼容？
在枚举层的字段别名有 非向后兼容 变动，务必 单元测试 解析器，否则连接即报错。
Q5：保留优先级修改最大频率？
单个 symbol 每分钟 20 次，超出触发 `-1003 (IP 封禁)。建议控制到 10 次/分钟** 以内。
七、结语
币安现货生态正朝着 更低延迟、更细粒度控制、更高安全 的方向演进。提前理解并测试每一次更新，是保障策略平稳运行的唯一捷径。祝你迁移顺利、收益长虹！