VeztaVezta
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

FieldTypeDescription
comboOrderIdstringCombo order identifier
statusstringOrder status (e.g. pending, placed, failed, settled)
failReasonstring | nullFailure 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.

On this page