{
"jsonrpc": "2.0",
"method": "public/subscribe",
"id": 42,
"params": {
"channels": [
"user.isolated.liquidation"
]
}
}{
"data": {
"state": "liquidation_started",
"user_id": 220042,
"isolated": true,
"currency": "USDC",
"margin_balance": 110,
"maintenance_margin": 120,
"initial_margin": 150,
"close_out_margin": 130,
"equity": 110,
"timestamp": 1750000400000
}
}user.isolated.liquidation
Lets a main account observe the liquidation, ADL, and LSP activity of all of its isolated-margin subaccounts, without subscribing to each subaccount’s own user.liquidation channel individually.
Every event on this channel is a fan-out copy of an event also delivered on the affected subaccount’s own user.liquidation channel — the payload is identical, including isolated: true and the subaccount’s user_id. The main account’s own liquidation activity is never delivered here; it stays on the main account’s regular user.liquidation channel.
Requires the account:read scope on an API key belonging to the main account, and is only available while isolated margin is enabled on the platform.
📖 Related Article: Liquidity Support Program (LSP) API Guide
{
"jsonrpc": "2.0",
"method": "public/subscribe",
"id": 42,
"params": {
"channels": [
"user.isolated.liquidation"
]
}
}{
"data": {
"state": "liquidation_started",
"user_id": 220042,
"isolated": true,
"currency": "USDC",
"margin_balance": 110,
"maintenance_margin": 120,
"initial_margin": 150,
"close_out_margin": 130,
"equity": 110,
"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?