Gate.io - 关于WebSocket与REST API成交记录字段调整的重要通知
最安全的虚拟币交易平台推荐：
- OKX（欧易交易所）>>>进入官网<<< >>>官方下载<<<
- Binance（币安交易所）>>>进入官网<<< >>>官方下载<<<
为了给开发者提供更稳定、高效的服务体验，Gate计划于 2025年5月下旬 对核心的 REST API 和 WebSocket API 进行一次重要升级。这次升级的核心在于部分接口字段的逻辑调整，因此，所有涉及相关接口调用的客户都需要提前关注并调整对接策略，以确保在升级窗口期实现平稳过渡。
一、WebSocket频道变更说明
受影响频道
- spot.trades（市场公开交易推送）
- spot.trades_v2（市场公开交易推送）
- spot.usertrades（用户私有交易推送）
- spot.usertrades_v2（用户私有交易推送）
字段调整
| 字段 | 变更类型 | 新规则 | 旧规则 | 兼容性说明 |
|---|---|---|---|---|
| id | 逻辑变更 | 当前市场内唯一 | 全局唯一 | 不再全局唯一 |
| id_market | 逻辑对齐 | 当前市场内唯一 | 当前市场内唯一 | 当前市场内唯一 |
这里需要特别注意id字段的变化：其唯一性范围将从“全局”收窄为“当前市场内”。这意味着，不同交易对（市场）的成交记录ID可能会出现重复值。如果你的系统逻辑依赖于ID的全局唯一性进行去重或关联，那么这就是本次调整中必须处理的关键点。
二、REST API变更说明
受影响端点
- GET /spot/trades
- GET /spot/my_trades
字段调整
| 字段 | 变更类型 | 新规则 | 旧规则 | 兼容性说明 |
|---|---|---|---|---|
| id | 逻辑变更 | 当前市场内唯一 | 全局唯一 | 不再全局唯一 |
| sequence_id | 逻辑对齐 | 当前市场内唯一 | 当前市场内唯一 | 当前市场内唯一 |
与WebSocket的调整保持一致，REST API中id字段的唯一性规则也同步改为“当前市场内唯一”。sequence_id字段的规则则保持不变。对于依赖这些接口进行数据同步、对账或监控的系统而言，务必根据新的ID规则复核相关逻辑。
感谢各位开发者一直以来的理解与支持。技术升级是为了更长远的路，过程中如有任何疑问，欢迎随时联系我们的技术支持团队。
Gate团队
2025年4月9日
加密货币之门
安全、快捷、轻松交易超过 3,800 种加密货币
立即行动
注册账户，最高可领 $10,000 迎新奖励
邀请他人注册，可获 40% 用金
关注官方渠道
访问Gate 官网
下载Gate App | 电脑端
关注X (Twitter)，获取最新福利
加入Telegram社群，讨论热点话题
进入全球社区，获取最新资讯
透明度保障
查看 100% 储备金证明
