Margin and Collateralization Framework

The Margin and Collateralization Framework is the core risk primitive of the dYdX protocol, establishing the precise mathematical rules for calculating initial margin, maintenance margin, and liquidation prices for all open positions. This standard governs how the protocol values collateral assets, applies haircuts, and determines whether a subaccount is adequately collateralized. For institutional traders and risk teams, this framework is the authoritative source for modeling portfolio risk, as it defines the exact conditions under which a position transitions from healthy to liquidatable.

The framework specifies a cross-margining model where all positions within a subaccount share a single collateral pool, allowing offsetting positions to reduce overall margin requirements. It details the stepwise liquidation process triggered when a subaccount's net collateral falls below its maintenance margin requirement, including the insurance fund's role as a backstop for unprofitable liquidations. Key parameters—such as initial_margin_fraction, maintenance_margin_fraction, and oracle price deviation bounds—are adjustable through on-chain governance, meaning risk profiles can shift with each governance vote.

Operators of liquidation bots, institutional trading desks, and exchange risk teams must implement this framework precisely to avoid failed liquidations, incorrect margin calls, or unexpected position closures. Chainscore Labs provides margin parameter risk analysis and liquidation model review, helping teams validate that their internal risk engines match the protocol's on-chain behavior before governance changes take effect or new markets are listed.

The dYdX Margin and Collateralization Framework defines the protocol's core risk engine, translating volatile market positions into a deterministic set of solvency conditions. It operates on a cross-margin model, where all of a subaccount's open positions and deposited collateral are aggregated into a single portfolio for risk assessment. The framework specifies the exact formulas for calculating the Initial Margin Requirement (IMR) to open a position and the Maintenance Margin Requirement (MMR) to keep it open. These requirements are derived from an IMF (International Monetary Fund) standard methodology adapted for crypto assets, using a combination of exponentially weighted moving average (EWMA) volatility and tail-risk shock factors to determine the minimum collateral needed against adverse price movements.

The framework's operational core is the liquidation process, which is triggered when a subaccount's total net collateral value falls below its total MMR. The protocol does not liquidate entire positions at once; instead, it employs a stepwise liquidation mechanism. A liquidation bot, operating off-chain, identifies an undercollateralized subaccount and submits a transaction to partially reduce its riskiest position by a fixed percentage. The bot receives a gas rebate and a small liquidation fee, while the remaining position stays open. This process repeats in subsequent blocks until the subaccount is recapitalized above the MMR or all positions are closed. The Insurance Fund acts as a backstop, automatically covering any remaining shortfall if a liquidation cannot be completed before a subaccount's equity turns negative, ensuring the protocol never carries bad debt.

For institutional traders and risk teams, this framework is the single source of truth for modeling portfolio risk and pre-trade capital requirements. The precise parameters—IMF shock factors, liquidation step sizes, and fee percentages—are not static; they are subject to on-chain governance proposals that can recalibrate the entire risk surface of the exchange. A governance vote to adjust the MMR for a specific market tier directly impacts the leverage available to all participants and the liquidation cascade risk during high-volatility events. Builders of liquidation bots, monitoring dashboards, and trading clients must implement their systems against this exact specification to correctly predict liquidation prices and respond to state changes, making the framework's deterministic logic a critical integration dependency.