WebSocket Reference
user:combo-orders
Combo (parlay) order status updates for the authenticated user
The user:combo-orders channel delivers status updates for the authenticated user's combo (multi-leg parlay) orders. Because combo placement is asynchronous — POST /api/v1/combos returns 202 Accepted and settlement runs in the combos worker domain — this channel is how a client learns when a combo transitions state without polling.
Subscribe
{ "event": "subscribe", "data": { "channel": "user:combo-orders" } }This channel requires authentication — connect with a valid JWT access token. Updates are scoped to the connecting user.
Unsubscribe
{ "event": "unsubscribe", "data": { "channel": "user:combo-orders" } }Server Broadcast
{
"channel": "user:combo-orders",
"data": {
"comboOrderId": "cmb-9f2a1c",
"status": "placed",
"failReason": null
}
}Payload Schema
| Field | Type | Description |
|---|---|---|
comboOrderId | string | Combo order identifier |
status | string | Order status (e.g. pending, placed, failed, settled) |
failReason | string | null | Failure reason when status is failed, otherwise null |
Notes
- Requires authentication — only the owning user receives updates.
- Pairs with the Combos API: create with
POST /api/v1/combos, then track transitions here.