Messages

{
  "data": {
    "state": "lsp_transfer",
    "user_id": 7,
    "instrument_name": "BTC-PERPETUAL",
    "direction": "sell",
    "amount": 5000,
    "price": 63481.75,
    "currency": "BTC",
    "commission": 1.25,
    "timestamp": 1750000400000
  }
}

User

user.liquidation

Notifications about the authenticated account’s own liquidation, auto-deleveraging (ADL), and LSP (Liquidity Support Program) activity — both as the account being liquidated/deleveraged and, for ADL, as a counterparty receiving a deleveraged position.

This includes the liquidated account’s own transfer events (lsp_transfer, adl_transfer) as well as adl_transfer_received for any account that absorbs a position via ADL. See user.lsp for the additional notifications sent to the LSP participant receiving an assigned position (enable/disable and configuration changes).

Every notification includes a state field identifying the stage of the process — see the notification schema for the full list of states and which fields accompany each.

Messages

{
  "data": {
    "state": "lsp_transfer",
    "user_id": 7,
    "instrument_name": "BTC-PERPETUAL",
    "direction": "sell",
    "amount": 5000,
    "price": 63481.75,
    "currency": "BTC",
    "commission": 1.25,
    "timestamp": 1750000400000
  }
}

Subscription Request

type:object

Client sends subscription request to subscribe to notification channel. Please refer to Notification page for more information.

Subscription Notification Data

type:object

Server sends subscription notification data

data

type:object

required

state

type:enum

required

The stage of the liquidation/ADL/LSP process this notification represents:

liquidation_started / liquidation_completed: The standard (order-book) liquidation process has started or completed for this account.
close_out_liquidation_started / close_out_liquidation_completed: The LSP/ADL close-out process has started or completed for this account. An account can go through this pair, the liquidation_started/liquidation_completed pair, or both in sequence (e.g. LSP/ADL close-out first, handed off to standard liquidation if it can't fully resolve the breach).
lsp_transfer: A position was transferred off this account to an LSP participant. Sent to the liquidated (source) account — see the user.lsp channel for the notification sent to the receiving participant.
adl_transfer: A position was auto-deleveraged off this account. Sent to the account being deleveraged (source).
adl_transfer_received: A position was auto-deleveraged onto this account from a counterparty. Sent to the receiving (counterparty) account.

Available options: liquidation_started, liquidation_completed, close_out_liquidation_started, close_out_liquidation_completed, lsp_transfer, adl_transfer, adl_transfer_received

user_id

type:integer

required

Unique user identifier

isolated

type:boolean

Present and true only when this event applies to an isolated-margin subaccount.

currency

type:enum

Currency, i.e "BTC", "ETH", "USDC"

Available options: BTC, ETH, USDC, USDT, EURR

margin_balance

type:number