User Channel
Stream private order and trade updates for an authenticated account
Use the User channel to track order placement, fills, cancellations, and trade settlement for the account associated with your L2 credentials.
Endpoint
wss://ws-subscriptions-clob.kuest.com/ws/user
Authenticate and subscribe
| Auth field | Required | Description |
|---|---|---|
apikey | Yes | UUID returned by the L1 credential flow |
secret | Yes | Base64 secret paired with the API key |
passphrase | Yes | Passphrase paired with the API key |
The markets array limits updates to selected condition IDs. Reuse the same L2
credentials used by private CLOB REST routes.
The subscription includes secrets. Open it only from a protected runtime and never log the full payload.
Message types
| Type | Lifecycle values |
|---|---|
order | PLACEMENT, UPDATE, CANCELLATION |
trade | MATCHED, MINED, CONFIRMED, FAILED |
Numeric fields are strings. owner, trade_owner, and order_owner are normalized to
the caller API key.
Reconnect safely
Messages include sequence, stream_id, and server_ts_ms. If the connection drops,
the stream changes, or a sequence is missing:
- fetch current open orders and relevant account state through REST;
- rebuild local state;
- reconnect and resume processing new messages.
Treat WebSocket messages as change notifications, not as the only durable record of an order or trade.
Try it
WebSocket Playground
Browser sockets cannot set custom Authorization headers. This widget appends the token as a query param.
Connection Log
No events yet.