How to switch between cross margin and isolated margin on OKX?

Understanding Margin Mode Fundamentals

1. Cross margin and isolated margin represent two distinct risk containment architectures within OKX’s derivatives infrastructure. Cross margin pools all available assets in the contract account to support open positions, while isolated margin allocates a fixed capital amount per position.

2. The choice directly impacts liquidation thresholds, leverage flexibility, and exposure correlation across instruments. A cross-margin position may draw from ETH, BTC, and USDT balances simultaneously; an isolated position locks only the designated collateral currency.

3. OKX enforces strict validation during order placement: if mgnMode is omitted or misconfigured in API requests, the system rejects the payload with error code 50113.

4. Web interface users must manually confirm margin mode before submitting any derivative order—no default fallback exists. The selection persists until explicitly changed, even across session restarts.

Switching Margin Modes via OKX Web Interface

1. Navigate to the “Contract Trading” page after logging into OKX.com. Ensure you are operating within the futures or perpetual swap section, not spot or options.

2. Locate the trading panel on the right side of the chart area. Below the price input field, identify the toggle labeled “Margin Mode” with two radio buttons: “Isolated” and “Cross”.

3. Click the desired mode. A confirmation dialog appears warning that existing positions will remain unaffected but new orders will adopt the selected mode.

4. After confirmation, the active margin mode displays in green text beside the order form. Any subsequent limit, market, or conditional order inherits this setting automatically.

API-Level Margin Mode Configuration

1. When constructing POST requests to /api/v5/trade/order, include the parameter mgnMode as a string with value “isolated” or “cross”.

2. For isolated positions, specify posSide as “long”, “short”, or “net” to define directional allocation boundaries. Cross margin ignores posSide for leverage calculation.

3. Leverage adjustments require separate API calls to /api/v5/account/set-leverage. The request body must contain instId, mgnMode, and lever fields.

4. Signature generation must incorporate the exact JSON body string without whitespace padding. Using json.dumps(..., separators=(',', ':')) prevents signature mismatch failures.

Unified Account Implications

1. Unified Account holders retain margin mode selection per instrument but gain cross-currency collateral conversion. An isolated BTC-USDT-SWAP position can use ETH as margin if ETH is enabled in the multi-currency margin configuration.

2. Cross margin under unified accounts aggregates all eligible assets—including stablecoins, blue-chip tokens, and selected altcoins—into a single risk pool governed by dynamic haircut rates.

3. Position-level isolation remains enforceable even in unified mode. Traders may activate isolated margin for high-volatility tokens like MEME while keeping BTC positions in cross mode.

4. The “Simple Mode” variant of unified accounts disables manual margin mode switching entirely, defaulting to cross margin with auto-optimized collateral distribution.

Risk Management Tool Integration

1. Stop-loss orders function identically across both modes but trigger different liquidation cascades. Isolated positions liquidate only the locked collateral; cross positions may initiate forced asset sales across the entire portfolio.

2. Auto-deleveraging (ADL) priority lists apply exclusively to cross margin users during extreme volatility. Isolated margin traders are excluded from ADL queues regardless of position size.

3. Funding rate accruals occur independently of margin mode. However, cross margin users experience faster funding balance erosion during prolonged negative funding periods due to shared equity depletion.

4. Historical PnL reports segment gains and losses by margin mode. OKX’s annual statement separates isolated and cross performance metrics to highlight structural risk differences.

Frequently Asked Questions

Q: Can I change margin mode for an already-open position? No. Margin mode is immutable once a position is established. To switch, close the existing position and reopen with the desired mgnMode parameter.

Q: Does changing margin mode affect unrealized PnL calculation? Unrealized PnL formulas remain identical. However, cross margin positions display aggregate equity changes while isolated positions show position-specific equity fluctuations.

Q: Why does my isolated position show zero available margin after opening? This occurs when the initial margin requirement equals or exceeds your total contract account balance. Isolated mode reserves the full amount upfront; no residual margin remains for additional orders.

Q: Are there fee differences between cross and isolated margin? Trading fees are identical. However, isolated positions incur minor overhead costs for real-time collateral valuation updates, reflected in slightly higher taker fees during volatile markets.