Positions

Endpoint: wss://api.testnet.arcus.xyz/v1/ws — one socket multiplexes every channel and RPC request. Click Connect, then send the example subscribe message below to start receiving data.

Open positions for a single sub-account. Snapshot on subscribe uses the same schema as REST GET /positions. Updates carry one PositionUpdate event per frame.

cumulativeFunding is absent from streaming events — use the snapshot for funding horizons. On close (size drops to 0), the row is emitted in FLAT form with zeroed financials.

leverage reflects the user’s per-(account, market) override (set via REST POST /v1/setLeverage) when present, otherwise the market default. A PositionUpdate is also emitted when the user adjusts leverage on a market they already hold a position in.

WSS

ws?channel=positions

Messages

Subscribe to an account channel

type:object

Positions Snapshot

type:object

Same schema as REST GET /positions (GetPositionsResponse) with isSnapshot: true. Sent once on subscribe.

Position Update

type:object

One position delta per frame (one PositionUpdate from go-core per SBE wire.PositionUpdateMsg). cumulativeFunding is absent; use the snapshot for funding horizons. On close, emitted in FLAT form with zeroed financials.

Account User fills