Monitor orders and positions in real time

This Guide shows how to combine an initial REST snapshot with live events so your application can maintain a reliable view of orders, trades and positions.

Step-by-step workflow

1. 1

   Read the initial order and position state

   Before opening the socket, read the current Order Book and Positions so the application starts from a known account state.

2. 2

   Connect to General WebSocket

   Open an authenticated General WebSocket connection and register the event handlers required by the workflow.

3. 3

   Subscribe to required event streams

   Subscribe to the supported order, trade, position or general events needed by the application.

4. 4

   Process order events

   Use order events to update status, quantities and rejection information. Match each event to the correct order identifier.

5. 5

   Process trade and position events

   Apply trade and position events to the local account view. Keep order state, executed trades and resulting positions as separate records.

6. 6

   Recover state after reconnect

   After a disconnection, read the latest REST state again before resuming event processing. This prevents missed events from leaving the application out of sync.

7. 7

   Verify the result

   Check the relevant API response and account or market-data state to confirm that the workflow completed successfully. If the result is partial or unsuccessful, review the returned status and message before deciding whether to retry or take another action.

Common issues

HTTP/1.1 401 Unauthorized
{"s":"error","code":-8,"message":"Could not authenticate the user"}

HTTP/1.1 400 Bad Request
{"s":"error","code":-50,"message":"Please provide valid order parameters"}

HTTP/1.1 429 Too Many Requests
Retry-After: 1
{"s":"error","message":"Rate limit exceeded"}

Error: socket hang up
ECONNRESET

Related API reference

Continue with AI