Margin Watch

Channel Name Schema

`margin.watch`

Subscribe to state of margin and MtM of all users.

Channel Parameters

Notification Data


channel string required Subscribed channel name
data array of objects required
data[].currency string required Currency of subaccount
data[].initial_margin string required Total initial margin requirement of all positions and collaterals.
data[].maintenance_margin string required Total maintenance margin requirement of all positions and collaterals.If this value falls below zero, the subaccount will be flagged for liquidation.
data[].margin_type string required Margin type of subaccount (`PM` (Portfolio Margin) or `SM` (Standard Margin)) enum `PM` `SM`
data[].subaccount_id integer required Subaccount_id
data[].subaccount_value string required Total mark-to-market value of all positions and collaterals
data[].valuation_timestamp integer required Timestamp (in seconds since epoch) of when margin and MtM were computed.
data[].collaterals array of objects required All collaterals that count towards margin of subaccount
data[].collaterals[].amount string required Asset amount of given collateral
data[].collaterals[].asset_name string required Asset name
data[].collaterals[].asset_type string required Type of asset collateral (currently always `erc20`) enum `erc20` `option` `perp`
data[].collaterals[].initial_margin string required USD value of collateral that contributes to initial margin
data[].collaterals[].maintenance_margin string required USD value of collateral that contributes to maintenance margin
data[].collaterals[].mark_price string required Current mark price of the asset
data[].collaterals[].mark_value string required USD value of the collateral (amount * mark price)

data[].positions array of objects required All active positions of subaccount
data[].positions[].amount string required Position amount held by subaccount
data[].positions[].delta string required Asset delta (w.r.t. forward price for options, `1.0` for perps)
data[].positions[].gamma string required Asset gamma (zero for non-options)
data[].positions[].index_price string required Current index (oracle) price for position's currency
data[].positions[].initial_margin string required USD initial margin requirement for this position
data[].positions[].instrument_name string required Instrument name (same as the base Asset name)
data[].positions[].instrument_type string required `erc20`, `option`, or `perp` enum `erc20` `option` `perp`
data[].positions[].liquidation_price string or null required Index price at which position will be liquidated
data[].positions[].maintenance_margin string required USD maintenance margin requirement for this position
data[].positions[].mark_price string required Current mark price for position's instrument
data[].positions[].mark_value string required USD value of the position; this represents how much USD can be recieved by fully closing the position at the current oracle price
data[].positions[].theta string required Asset theta (zero for non-options)
data[].positions[].vega string required Asset vega (zero for non-options)

Example

Subscriptions are only available via websockets.

{request_example_javascript}

{request_example_python}

Notification messages on this channel will look like this:

{response_example_json}