跳到主要内容
版本:Next (V2.0)

WebSocket 连接说明

连接地址

模块WebSocket 地址说明
现货/api/v1/ws/klineK线实时推送
合约/api/v1/futures/ws订单簿、Ticker、K线推送

通用规则

项目说明
协议WebSocket (ws:// 或 wss://)
数据格式JSON
心跳超时现货 60 秒无消息自动断开;合约 70 秒无消息自动断开
建议心跳间隔每 20 秒发送一次 ping

连接示例

现货 K线:

wss://api9528mystks.mystonks.org/api/v1/ws/kline

合约行情:

wss://api9528mystks.mystonks.org/api/v1/futures/ws

心跳机制

心跳请求:

{"action": "ping"}

现货心跳响应:

{"event": "pong", "time": 1736163000000}

合约心跳响应:

{"event": "pong", "timestamp": 1736163000000}
提示

现货和合约使用不同的 WebSocket 连接地址,心跳超时和部分推送结构也存在差异,请以各模块文档为准。