可能引发兼容性问题的WebSocket ID生成API更新...

2023年6月26日和7月10日，我们将对WebSocket API进行重要更新，以适应未来平台的升级需求。本次更新可能会对某些应用程序的兼容性产生影响，因此建议开发者尽早进行调整。

有什么变化？

在此次更新中，orderBookL2 和 orderBookL2_25 行中的 ID 将变为任意值，不再能够直接转换为价格水平。为此，我们对消息结构进行了以下调整：

• 所有插入、更新和删除消息现在都明确提供价格。
• 由于 ID 不再适用于排序，建议开发者改用价格进行排序。

这些更改旨在提升系统的灵活性，同时简化用户获取订单价格的方式。

应用程序的调整建议

如果您的应用程序受到此次更改的影响，请按照以下建议进行调整：

• 使用“更新”消息中提供的价格字段。
• 按价格对订单簿进行排序，而不是依赖 ID。

通过这些调整，您可以确保应用程序在新 API 环境下的正常运行。

示例消息

旧版实现

在旧版中，ID 的生成算法限制了系统的后端灵活性，同时通过订单 ID 获取价格的方式较为复杂。此次更新优化了这一机制，使交易者能够更轻松地解析流数据并获取订单价格。

部署时间表

此次影响 ID 的 API 更改将按照以下时间表逐步实施：

• 5月25日：测试网（Testnet.bitmex.com） – 涉及所有交易符号。

• 6月26日：生产环境（www.bitmex.com） – 仅适用于以下交易工具：
  DOTUSDT、USDTUSDC、SUIUSD、AXSUSD、XBTU23、SOL_USDT、GMXUSDT、ETHUSD_ETH、AVAXUSD、APTUSD、TRX_USDT、XBTZ23、XBTUSDTM23、ETHUDM23、ETHOSDM23、ETHM23、NERUSD、BLURUDT、EOSUSD、BLURUSD、MATIC-USDT、CROUSD、XBTUSTU23、AVAXUSDT、BMEXUSD、FLRUSD、ADAM23、GMTUSDT、LUNUSD、FLOKIUSDT、LINK_USDT、GMTUSD、ARBUSD、ARBUSDTM23、1TAIDOGUSDT、UNI_USDT、AXS_USDT、APE_USDT

• 7月10日：生产环境 – 涉及所有剩余交易符号，包括 XBTUSD 和 ETHUSD 等热门交易对。

开发者可以从即日起开始迁移，无需等待上述时间点。所有插入和更新消息均已明确提供价格字段。

总结

此次 WebSocket API 更新旨在为未来的系统升级提供更高的灵活性，同时简化了用户获取订单价格的方式。建议开发者尽早调整应用程序，确保兼容新 API 的变化。通过按价格排序，您可以更高效地管理订单簿数据。

原文链接: https://blog.bitmex.com/api_announcement/removing-id-schema-on-orderbook-feeds/