Account Liquidations

Refer to Websocket for establishing the websocket connection. This channel requires the account’s API key. Open the connection with the PF-API-KEY header set to a key that belongs to the subscribed account, as described in API Config Keys. Any other subscribe fails with code 403. There is no exchange-wide liquidation channel.

Params

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

Stream

The channel sends no snapshot on subscribe. It sends each event once, as it happens.

{
  "channel": "account_liquidations",
  "data": [
    {
      "u": "42trU9A5...",
      "s": "BTC",
      "m": "adl",
      "d": "ask",
      "a": "0.25",
      "p": "64210",
      "i": null,
      "t": 1760630400000,
      "li": 9123
    }
  ]
}

Field	Type	Description
`’u’`	string	Account address
`’s’`	string	Symbol
`’m’`	string	How the position closed. See below
`’d’`	string	Side of the closed position: `‘bid’` - long, `‘ask’` - short
`’a’`	decimal string	Closed amount
`’p’`	decimal string	Average fill price for `‘market’`, otherwise the transfer or ADL price
`’i’`	integer	Liquidation order ID for `‘market’`, otherwise `null`
`’t’`	number	Timestamp in milliseconds
`’li’`	number	Last ID — sequence number of the operation

Mechanism (`'m'`)

`'m'`	Account was	How the position closed
`'market'`	Liquidated	An IOC liquidation order filled on the book
`'backstop'`	Liquidated	Transferred to the backstop liquidator
`'adl_liquidated'`	Liquidated	Closed against ADL counterparties
`'adl'`	An ADL counterparty	Auto-deleveraged to cover another account’s liquidation

Every value except 'adl' means the account was liquidated. 'adl' names the profitable side that ADL closed. A chunked market liquidation sends one event for each chunk that fills. The trades that the close produced arrive on Account Trades with the same li. Join them on (li, u, s). The channel does not report delisting closes or the backstop liquidator’s side of a transfer.

​Params

​Stream

​Mechanism ('m')

Params

Stream

Mechanism (`'m'`)