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.
Default Leverage and Margin Mode
Every position uses one of two margin modes. Cross margin backs the position with the account’s shared free collateral. Isolated margin backs the position only with the collateral allocated to it. The exchange may assign your account to a group with shared leverage or margin defaults. Each setting resolves independently for each instrument:
Group defaults also apply to future listings. An explicit per-instrument setting
is retained when group defaults or membership change.
Set your preferred leverage and margin mode after the instrument is listed and
before placing your first order, using
Update Leverage. Account configuration reads
report the resolved values; an update sets both values explicitly. Setting the
current resolved pair explicitly preserves it against later group changes.
Before switching between isolated and cross margin:
- Close the position in that instrument.
- Cancel all orders in that instrument, including orders awaiting risk approval or execution.
- Check that the instrument supports the requested margin mode.
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.Withdrawal Margin Requirements
Withdrawals must leave enough collateral to cover existing margin commitments and at least 10% of the total notional value of all open positions:TotalPositionValue includes both cross and isolated positions at current Mark
Price. CollateralReserved covers cross-position initial margin, isolated
collateral allocations, and margin and fee reserves for accepted open orders.
For a cross-only account with no open orders, it equals required initial margin.
The 10% floor applies to withdrawals, independently of the leverage used to open
a position. It does not increase the opening-margin requirement or change the
maintenance-margin threshold for liquidation.
For example, assume a $100 position at 20x, no other positions or orders, and no
fees, funding, or unrealized PnL:
How is the withdrawable balance calculated?
How is the withdrawable balance calculated?
The account’s withdrawal capacity in USD is:
CollateralValue is the account’s valued collateral. CrossUnrealizedPnL
includes only cross positions; isolated unrealized PnL is not added to
withdrawal equity. PendingOrderMargin is the additional initial margin
reserved for orders still awaiting risk checks.Use the returned withdrawable value from Get Portfolio
rather than subtracting initial margin from account equity. A withdrawal is
also limited by the balance of the asset being withdrawn and is checked again
when processed.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.
Removing isolated margin releases collateral within the account. This uses the
position’s initial-margin check above; withdrawing the released collateral from
the account must also satisfy the withdrawal margin requirements.
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.