首页 资讯 正文

XT关于现货及合约WebSocket行情推送启用强制压缩的公告

XT.COM 2026年11月10日 08:30

尊敬的XT用户：
 

为进一步优化平台行情数据传输效率，降低网络带宽占用，提升 WebSocket 行情服务的稳定性及整体性能，XT将于2026年12月10日16:00（UTC 8）起，将对现货及合约 WebSocket 公共行情推送机制进行升级。升级结束后，现货及合约 WebSocket 行情推送将统一启用强制数据压缩机制。届时，未启用压缩的客户端将无法建立连接，请API用户尽快完成调整。
 

一、影响范围

  • 无需操作：XT App、网页端已默认启用压缩，普通用户无需任何操作。
  • 不受影响：现货与合约的私有推送（账户、订单、持仓等）以及 REST API。
  • 需要调整：通过 WebSocket 接入现货、合约公共行情的API用户。

二、时间安排

  • 建议API用户即日起，按照已支持压缩的地址，尽快完成压缩调整。
  • 2026年12月10日16:00（UTC 8）起：未能与服务端协商启用压缩（permessage-deflate）的连接将被拒绝。

三、如何调整

接入地址：
业务
接入地址
现货公共行情
wss://stream.xt.com/public
合约公共行情
wss://fstream.xt.com/ws/market
压缩采用 WebSocket 标准扩展 permessage-deflate（RFC 7692），由WebSocket库自动完成压缩和解压，推送内容和格式不变，业务代码无需修改，只需在建立连接时开启压缩：
语言 / 库
开启方式
Python websockets
默认已开启，无需修改
Python aiohttp
session.ws_connect(url, compress=15)（默认不开启，需修改）
Python websocket-client
不支持压缩，请更换为 websockets 或 aiohttp
Node.js ws / 内置 WebSocket
默认已开启，无需修改
Go gorilla/websocket
websocket.Dialer{EnableCompression: true}
Java Netty
在 pipeline 中添加 WebSocketClientCompressionHandler.INSTANCE
C Boost.Beast
permessage_deflate opt; opt.client_enable = true; ws.set_option(opt);
浏览器
默认已开启，无需修改
自查方法：连接成功后，查看服务端握手响应头。如包含 Sec-WebSocket-Extensions: permessage-deflate，即表示已启用压缩，无需进一步操作。
 
注意：
  1. 请务必在2026年12月10日前完成调整并测试，以免影响行情接收和策略运行。
  2. 如机构用户需要协助或延长过渡期，请联系您的客户经理。
  3. 如需获得更多信息请查阅 XT API 文档。