{
"type": "derivatives.margin_updated",
"user_id": "AA55 N84G QOIR A67A",
"account_id": "WCQY T95Y CUL2 A7NX",
"cash_balance_in_quote": "50000",
"pnl": {
"unrealized_in_quote": "20"
},
"margin": {
"standard": {
"initial_requirement_in_quote": "1000",
"maintenance_requirement_in_quote": "800",
"withheld_in_quote": "1500"
},
"intraday": {
"initial_requirement_in_quote": "500",
"withheld_in_quote": "750"
}
},
"distance_to_liquidation_in_quote": "49220",
"updated_at": "2026-09-28T12:00:00+00:00"
}Webhooks
Derivatives margin updated
US perpetuals margin state after an account update. The user identifies whose margin changed, including a partner’s end users. Each update carries the complete margin state. This event does not provide an initial snapshot or EEA perpetuals margin. Delivery can be retried and is not guaranteed to be ordered. Compare updated_at and reconcile current account state when ordering matters.
WEBHOOK
derivatives.margin_updated
{
"type": "derivatives.margin_updated",
"user_id": "AA55 N84G QOIR A67A",
"account_id": "WCQY T95Y CUL2 A7NX",
"cash_balance_in_quote": "50000",
"pnl": {
"unrealized_in_quote": "20"
},
"margin": {
"standard": {
"initial_requirement_in_quote": "1000",
"maintenance_requirement_in_quote": "800",
"withheld_in_quote": "1500"
},
"intraday": {
"initial_requirement_in_quote": "500",
"withheld_in_quote": "750"
}
},
"distance_to_liquidation_in_quote": "49220",
"updated_at": "2026-09-28T12:00:00+00:00"
}Body
application/json
US perpetuals margin state reported for a user. All amounts are in USD, the quote currency of US perpetuals. Each update carries the complete state and replaces the previously received one.
Response
2XX
Delivery endpoint accepted the webhook.