Skip to main content
Refer to Websocket for establishing the websocket connection.

​
Params

{
    "method": "subscribe",
    "params": {
        "source": "account_positions",
        "account": "42trU9A5..."
    }
}

​
Positions Snapshots

Upon subscription, the account_positions websocket immediately returns a snapshot of all current positions, then begins streaming all changes made to an account’s positions in a best effort picture of current state.

We recommend using account_positions for initialization, and account_trades, to construct up-to-date positions state.

​
Stream

{
  "channel": "subscribe",
  "data": {
    "source": "account_positions",
    "account": "BrZp5..."
  }
}
// this is the initialization snapshot
{
  "channel": "account_positions", 
  "data": [
    {
      "s": "BTC",
      "d": "bid",
      "a": "0.00022",
      "p": "87185",
      "m": "0",
      "f": "-0.00023989",
      "i": false,
      "l": null,
      "t": 1764133203991
    }
  ],
  "li": 1559395580
}
// this shows the position being increased by an order filling
{
  "channel": "account_positions",
  "data": [
    {
      "s": "BTC",
      "d": "bid",
      "a": "0.00044",
      "p": "87285.5",
      "m": "0",
      "f": "-0.00023989",
      "i": false,
      "l": "-95166.79231",
      "t": 1764133656974
    }
  ],
  "li": 1559412952
}
// this shows the position being closed
{
  "channel": "account_positions",
  "data": [],
  "li": 1559438203
}
FieldTypeDescription
’s’stringSymbol
’d’stringPosition side (bid, ask)
‘a’decimal stringPosition amount
’p’decimal stringAverage entry price
’m’decimal stringPosition margin
’f’decimal stringPosition funding fee
’i’boolIs position isolated?
‘l’decimal stringLiquidation price in USD (null if not applicable)
‘t’numberTimestamp in milliseconds
’li’numberExchange-wide nonce. Used to reliably determine exchange event ordering. Sequential and not subject to clock drift.