{
"jsonrpc": "2.0",
"method": "public/subscribe",
"id": 42,
"params": {
"channels": [
"user.liquidation"
]
}
}{
"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.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.
📖 Related Article: Liquidity Support Program (LSP) API Guide
{
"jsonrpc": "2.0",
"method": "public/subscribe",
"id": 42,
"params": {
"channels": [
"user.liquidation"
]
}
}{
"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
}
}Client sends subscription request to subscribe to notification channel. Please refer to Notification page for more information.
Server sends subscription notification data
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, theliquidation_started/liquidation_completedpair, 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 theuser.lspchannel 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.
liquidation_started, liquidation_completed, close_out_liquidation_started, close_out_liquidation_completed, lsp_transfer, adl_transfer, adl_transfer_receivedUnique user identifier
Present and true only when this event applies to an isolated-margin subaccount.
Currency, i.e "BTC", "ETH", "USDC"
BTC, ETH, USDC, USDT, EURRPresent for liquidation_started, liquidation_completed, close_out_liquidation_started, and close_out_liquidation_completed.
Present for liquidation_started, liquidation_completed, close_out_liquidation_started, and close_out_liquidation_completed.
Present for liquidation_started, liquidation_completed, close_out_liquidation_started, and close_out_liquidation_completed.
Present for liquidation_started, liquidation_completed, close_out_liquidation_started, and close_out_liquidation_completed.
Present for liquidation_started, liquidation_completed, close_out_liquidation_started, and close_out_liquidation_completed.
Unique instrument identifier
Present for lsp_transfer, adl_transfer, and adl_transfer_received. This account's own resulting position side.
buy, sellPresent for lsp_transfer, adl_transfer, and adl_transfer_received.
Present for lsp_transfer, adl_transfer, and adl_transfer_received. The transfer price applied.
Present for lsp_transfer, adl_transfer, and adl_transfer_received. The commission charged (on lsp_transfer/adl_transfer) or this account's share of the commission (on adl_transfer_received, proportional to the position this account absorbed). Intra-account subaccount ADL moves are commissioned the same way as moves onto another user's account.
The timestamp (milliseconds since the Unix epoch)
Was this page helpful?