Equity
Equity is the real-time value of an account, incorporating all open positions at current Mark Price.Unrealized PnL
Margin Requirements
Initial margin is set by your configured leverage:max_leverage is below your configured leverage is rejected
with invalid_leverage, and you must lower your leverage setting first. Your
configured leverage applies to your entire notional, not bracket by bracket.
Fetch each market’s tier schedule from
Market Data.
Maintenance margin uses a flat per-market rate, independent of position size,
tier, and your leverage setting:
MaxLeverage is the market’s maximum leverage, so on a 20x market
MMR = 2.5% for every position. MM equals half the initial margin of a
position opened at max leverage; at lower leverage your IM is higher but MM
stays the same, so the gap between entry requirement and liquidation grows.
Margin requirements are static across sessions.
Margin States
An account is always in one of three states.Margin Checks
Pre-Trade
Before any order executes, the system verifies the account can afford it:- Compute the new position after the order fills.
- Calculate required initial margin using the market’s leverage tiers.
- Reject the order if equity is below required initial margin.
Continuous Monitoring
The system continuously evaluates accounts:- If equity falls below maintenance margin, liquidation begins.
- If equity is between maintenance margin and initial margin, the account may enter reduce-only mode.
Deposits and Withdrawals
Deposits increase equity. A deposit during margin call can restore the account to healthy status immediately. Withdrawals require the account to remain above required initial margin after the withdrawal. You cannot withdraw yourself into a margin call.Adjusting Isolated Margin
For each position,initial_margin reports the collateral currently backing
the position. For cross positions, it is the required initial margin based on
position size, Mark Price, the applicable risk tier, and configured leverage.
For isolated positions, it is the position’s current equity:
initial_margin name is retained for API compatibility;
margin would describe this value more accurately.
A positive margin adjustment moves free account collateral into the isolated
allocation. A negative adjustment releases value back to free collateral and
may include unrealized profit, so the signed allocation itself can reach zero
or become negative. The request is accepted only when the resulting position
equity remains at or above current required initial margin.
Both additions and removals are blocked while the account is in cross
liquidation or the target position is in isolated liquidation. An isolated
liquidation on a different instrument does not block the request. Cancel-only
mode does not gate margin adjustments.