Refer friends and earn rewards this week
Kongo Docs

User

Subscribe to authenticated user updates over WebSocket

Get Help

Authenticated stream for order and trade updates scoped to your API credentials.

Endpoint

  • Production: wss://ws-subscriptions-clob.kuest.com/ws/user

Required auth object

FieldRequiredDescription
apikeyYesUUID v4 API key returned by POST /auth/api-key.
secretYesBase64 secret paired with the API key.
passphraseYesHex passphrase used with the secret.

Event types

  • trade: trade lifecycle updates (MATCHED, MINED, CONFIRMED, FAILED).
  • order: order lifecycle updates (PLACEMENT, UPDATE, CANCELLATION).

Notes

  • Numeric fields are strings.
  • owner, trade_owner, and order_owner are normalized to the caller API key.
  • Live events include sequence, stream_id, and server_ts_ms; refetch your active orders if you reconnect or detect a missed event.
  • Reuse the same L2 credentials used for private REST endpoints.

WebSocket Playground

WebSocket Playground

Browser sockets cannot set custom Authorization headers. This widget appends the token as a query param.

Disconnected
wss://ws-subscriptions-clob.kuest.com/ws/user

Connection Log

No events yet.