概述
本文档汇总了 Binance 现货 API 的关键更新、功能优化与变更事项，旨在为开发者提供清晰、及时的接口调整信息。所有变更均以提升系统性能、安全性与开发者体验为目标。
近期重要更新 (2025年)
2025-07-03: WebSocket 账户接口升级
自 2025-07-08 07:00 UTC 起，WebSocket 账户接口将进行系统升级。
- 升级窗口：预计持续2小时，期间现有连接与新连接可能在24小时内出现间断性断开。
- 建议措施：请合理安排重连机制，避免关键操作在此期间进行。
2025-06-04: SBE 2.0 模式禁用
根据 SBE 政策，SBE 2.0 模式将于 2025年06月12日 正式禁用（废止满6个月后）。请尽快迁移至新模式。
2025-05-28: API 超时与错误记录规范
在“API 基本信息”章节下，全面记录各 API 的超时值与错误代码：
- FIX API：明确通用接口信息
- REST API：更新常规接口说明
- WebSocket API：补充连接规范
2025-05-22: 时间窗口检查强化
自 2025年6月6日 7:00 (UTC) 起，FIX、REST 和 WebSocket API 将加强对 recvWindow 的校验逻辑：
现有行为：
- 若请求时
timestamp与服务器时间差超过recvWindow，则拒绝请求（增加消息/IP限制，但不计入未成交订单数）
- 若请求时
新增检查：
- 请求转发至撮合引擎前，若时间差仍超限，则拒绝请求（同时增加未成交订单计数）
- 文档同步更新：Timing 安全性文档已涵盖此变更。
2025-04-29: API 密钥类型扩展
原仅支持 Ed25519 API 密钥的功能，将逐步开放给 HMAC 和 RSA 密钥：
- 示例：WebSocket API 中订阅账户数据流将支持多种密钥类型
- 建议：仍推荐迁移至 Ed25519 密钥，因其具备更高的安全性与性能表现
功能优化与性能提升
请求权重调整
多项接口的请求权重已调整，以更合理分配系统资源：
PUT /api/v3/order/amend/keepPriority权重从 1 增至 4GET /api/v3/aggTrade权重从 2 增至 4- 深度查询接口（
GET /api/v3/depth）权重按档位分级优化
微秒级时间支持
系统现已支持微秒级时间精度（可选启用）：
- WebSocket Streams：通过
timeUnit参数选择时间单位（默认毫秒） - REST API：通过报文头
X-MBX-TIME-UNIT指定单位 - WebSocket API：同样支持
timeUnit参数
错误代码与消息优化
- 新增错误代码
-2038、-2039，更精准标识订单查询与修改失败场景 - 统一错误消息格式，如精度超限提示改为“参数‘%s’精度过高”
常见问题
1. 如何选择 API 密钥类型？
HMAC、RSA 和 Ed25519 密钥均可用，但 Ed25519 在安全性和性能上更优，建议新项目优先采用。原有密钥类型可继续使用，但部分新功能可能仅支持 Ed25519。
2. WebSocket 接口升级期间需要注意什么？
升级可能导致连接中断，建议客户端实现自动重连逻辑，并避免在维护窗口内执行关键交易操作。升级完成后，部分旧接口可能停用，请及时订阅官方通知。
3. 时间戳参数有哪些规范？
时间戳需在合理范围内（2017年1月1日后，且不超过服务器时间10秒），否则请求将被拒绝。微秒支持为可选功能，默认仍使用毫秒。
4. 订单查询返回“-2026”错误怎么办？
该错误表示订单因长时间无成交且已归档，无法查询详情。请确保查询90天内活跃订单，或联系技术支持恢复数据（如必需）。
5. 如何降低 API 请求权重消耗？
合理利用 WebSocket 流推送替代频繁轮询，合并查询请求（如使用 symbols 参数批量获取行情），并遵循接口权重限制规划调用频率。
6. SBE 模式迁移有哪些注意事项？
禁用旧模式前6个月会发布公告，请及时更新解码器并测试新模式兼容性。生产环境建议逐步灰度切换，避免中断业务。
总结
Binance 现货 API 持续迭代，旨在为开发者提供更稳定、高效的服务。建议密切关注官方更新日志，及时调整接入逻辑，并充分利用新特性优化交易系统。