WebSocket Connection Guide
Connection Addresses
| Module | WebSocket Address | Description |
|---|---|---|
| Spot | /api/v1/ws/kline | Real-time K-line push |
| Futures | /api/v1/futures/ws | Order book, Ticker, K-line push |
General Rules
| Item | Description |
|---|---|
| Protocol | WebSocket (ws:// or wss://) |
| Data Format | JSON |
| Heartbeat Timeout | Spot: auto disconnect after 60 seconds of no message; Futures: auto disconnect after 70 seconds of no message |
| Recommended Heartbeat Interval | Send ping every 20 seconds |
Connection Examples
Spot K-line:
wss://api9528mystks.mystonks.org/api/v1/ws/kline
Futures Market Data:
wss://api9528mystks.mystonks.org/api/v1/futures/ws
Heartbeat Mechanism
Heartbeat Request:
{"action": "ping"}
Spot Heartbeat Response:
{"event": "pong", "time": 1736163000000}
Futures Heartbeat Response:
{"event": "pong", "timestamp": 1736163000000}
Tip
Spot and Futures use different WebSocket connection addresses, heartbeat timeouts and some push structures also differ. Please refer to each module's documentation for details.