{
"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.
{
"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)
Related topics
Liquidity Support Program (LSP) API Guideuser.liquidation Mass Quotes Specificationsuser.lsp JSON-RPC API ChangelogWas this page helpful?