Margin updates

Real-time account margin and equity updates. Requires authentication.

{"op": "subscribe", "args": ["margin"]}

Topic format: margin (per-account, not per-symbol).

Update Message

Pushed per collateral currency when its margin state changes (mark price moves, trades, deposits, withdrawals, funding payments). Each message is a full replacement for one currency.

{
  "channel": "margin",
  "type": "update",
  "customer_code": "c1d2e3f4-a5b6-7890-cdef-123456789abc",
  "currency": "USD",
  "total_equity": "125430.50",
  "available_margin": "98750.25",
  "used_margin": "26680.25",
  "margin_ratio": "0.2127",
  "unrealised_pnl": "1430.50",
  "timestamp": "2025-06-15T07:30:00.123Z"
}

Field	Description
`customer_code`	Customer identifier
`currency`	Collateral currency (e.g. USD, BTC, ETH)
`total_equity`	Total account equity (balance + unrealised PnL)
`available_margin`	Margin available for new positions
`used_margin`	Margin currently used by open positions and orders
`margin_ratio`	Used margin as a fraction of total equity (e.g., 0.21 = 21%)
`unrealised_pnl`	Total unrealised profit/loss across all positions
`timestamp`	Server-side event time (maps to `updated_at` in REST)

Notes:

There is no initial snapshot on subscribe — use REST GET /customers/{code}/account-summary for current state.
Fields match the REST AccountSummaryItem schema (updated_at → timestamp, realised_pnl omitted).