WebSocket API 接入文档

实时交易信号

1. 接入地址

WebSocket服务地址：

wss://labs.cabot.my/ws

支持通过 signals 参数订阅多个主题，例如：

wss://labs.cabot.my/ws?signals=btcusdt@marketSignal/ethusdt@marketSignal/solusdt@marketSignal

订阅全部交易对：

wss://labs.cabot.my/ws?signals=all@marketSignal

2. 连接与订阅

• 建立WebSocket连接时，通过 signals 参数指定订阅的交易对（多个用 / 分隔，格式为 交易对@marketSignal）。
• 如需订阅全部交易对，使用 signals=all@marketSignal。
• 连接建立后即可接收所订阅交易对的推送数据。
• 如需变更订阅，可发送文本消息到服务端（具体格式可自定义）。

3. 心跳与连接保活

• 客户端必须定期（建议每30秒~1分钟）发送 ping 文本消息。
• 服务端收到 ping 后会回复 pong。
• 如果服务端在90秒内未收到客户端的ping消息，连接将被自动断开。
• 客户端如果在60秒内未收到pong响应，应考虑重新建立连接。

websocket.send("ping"); // 客户端定时发送
// 收到 pong 响应

4. 消息格式说明

• 推送数据为文本消息，内容格式由服务端定义（如JSON字符串）。
• 客户端主动发消息（如心跳、订阅变更）时，服务端会原样回复或按需处理。
• 服务端推送数据格式为JSON字符串。

{
  "lastTime": 1763267779835,
  "symbol": "ASTER/USDT",
  "trend": "RADICAL_LONG",
  "currentPrice": 1.157,
  "upPrice": 1.18268000,
  "unPrice": 1.10028000
}
            

5. 注意事项

• 请务必实现心跳机制，否则长时间不活跃会被服务端断开。
• 交易对是小写。
• 如有疑问请联系技术支持。