XT交易所Websocket API

最新推荐文章于 2025-09-07 16:08:17 发布

原创

最新推荐文章于 2025-09-07 16:08:17 发布 · 815 阅读

0 ·

CC 4.0 BY-SA版权

本文介绍了XT交易所的WebSocket API接入，包括数据压缩、心跳消息机制、断开连接的条件、订阅和取消订阅主题的详细步骤，以及各种行情数据（如K线、聚合行情、市场深度和最新成交）的订阅与退订操作。

接入说明

WEBSOCKET API

wss://ws.xt.com/websocket

数据压缩

WebSocket API 的所有数据都 GZIP 压缩之后再进行 Base64.encode() 编码并使用二进制方式返回，需要 client 在收到二进制数据之后进行解码解压。

心跳消息

当用户的Websocket客户端连接到Ubiex Websocket服务器后，服务器会定期（当前设为5秒）向其发送ping消息并包含一个时间戳，

当用户接收到此心跳消息后，应及时返回pong消息并包含同一时间戳，格式如：

{
   
   "ping": 1562979600}

{
   
   "pong": 1562979600}

当Websocket服务器连续三次发送了ping消息却没有收到任何一次pong消息返回后，服务器将主动断开与此客户端的连接。

当然，用户连接到服务器后，也可以主动向服务器发送消息ping，当服务器接到信息为ping字符串后主动返回一个pong的字符串。

断开连接

用户主动断开或者主动向Ubiex Websocket服务器发送消息close；

订阅主题

成功建立与Websocket服务器的连接后，Websocket客户端应发送如下请求以订阅特定主题：


{
   
   "channel":"ex_single_market","market":{
   
   Market},"event":"addChannel"}

{
   
   "channel":"ex_group_market","group":{
   
   Group},"event":"addChannel"}

{
   
   "channel":"ex_last_trade","market":{
   
   Market},"since":{
   
   Since},"event":"addChannel"}

{
   
   "channel":"ex_depth_data","market":{
   
   Market},"event":"addChannel"}

{
   
   "channel":"ex_chart_update","market":{
   
   Market},"since":{
   
   Since},"interval":{
   
   Interval},"event":