Skip to main content
This page covers subscribing to position updates with subscribe_positions, and the positions payload that subscription delivers.

Subscribing to position updates

Subscribe to real-time position changes by emitting subscribe_positions. This requires an HMAC-signed handshake. See Authentication. subscribe_positions accepts the same payload as subscribe_market_prices:
Like subscribe_market_prices, calling subscribe_positions again replaces the previous subscription. Include all markets in a single call.
Position updates are pushed automatically when your balances change (e.g. after a trade is mined). You do not need to poll.

Event payload

positions

Position updates have different shapes depending on market type. AMM markets:
CLOB markets:
  • WebSocket overview: connection details, handshake authentication, and the full event reference