User Notifications

Authenticate the socket to receive updates for the signed-in user. Message shapes are in WebSocket Protocol. No initial state is sent when the socket authenticates. Seed balances, positions, and orders from GET /execution/balances, GET /execution/positions, and GET /execution/orders, then apply socket updates. See Portfolio and Order lifecycle. A fill is the socket event order_event with event filled or partial_fill, and the webhook event trades.filled. See Webhooks.

Refresh-aware reconnect

If the socket closes and the access token may have expired, refresh it before reconnecting, then seed from REST again.

let accessToken = initialAccessToken;

function connect() {
  const ws = new WebSocket(
    `wss://ws.agg.market/ws?appId=${appId}&token=${accessToken}`,
  );

  ws.onclose = async () => {
    try {
      accessToken = await client.refreshAccessToken();
    } catch {
      await client.signOut();
      return;
    }

    setTimeout(connect, 1000);
  };
}

connect();

WebSocket Protocol

Authenticated user-event frames.

Order lifecycle

Statuses to poll when the socket was down.

Portfolio

Activity and the leaderboard.

Webhooks

trades.filled on your server.

Start here

Core concepts

Account

Trading

Venues

Market data

Security

Real-time

Webhooks

Your users

UI Kit

Releases

Refresh-aware reconnect

WebSocket Protocol

Order lifecycle

Portfolio

Webhooks

​Refresh-aware reconnect

​Related

WebSocket Protocol

Order lifecycle

Portfolio

Webhooks

Refresh-aware reconnect

Related