{
"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.
{
"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)
Related topics
user.isolated.liquidation user.lsp Liquidity Support Program (LSP) API GuideJSON-RPC API Changelogprivate/get_user_trades_by_orderWas this page helpful?