Real-time Subscription (WebSocket)

Real-time Data Subscription (WebSocket)

URL: wss://mmapi.55-tech.com/ws/subscribe

Connection Limits: Maximum 5 concurrent connections per API key.

Protocol

1. Connect to /ws/subscribe

2. Subscribe (within 30 seconds):

{
  "type": "subscribe",
  "api_key": "your-client-api-key-uuid",
  "channels": ["orders", "bets", "accounts", "scores", "emergency"]
}

3. Confirmation:

{"type": "subscribed", "subscription_id": 1, "channels": ["orders", "bets"]}

4. Receive broadcasts:

{
  "type": "broadcast",
  "channel": "orders",
  "event": "UPDATE",
  "payload": {"id": 123, "orderStatus": "FILLED"},
  "old": {"orderStatus": "PLACED"}
}

5. Keep-alive: Send {"type": "ping"} → Receive {"type": "pong"}

6. Heartbeat: Server sends {"type": "heartbeat"} every 60s

7. Unsubscribe: Send {"type": "unsubscribe"}

Channels

Error Codes

• api_key required - Missing api_key
• Invalid api_key format - Must be UUID
• Invalid API key - Not found or inactive
• Connection limit exceeded - Max 5 per API key