Margin Accounts and Collateralization Accounting

See also: Margin Accounting Concepts and Terms:

pageMargin Accounting Concepts and TermspagePools/Variable Lending Concepts and Terms

A margin account a ledger within a ledger, keeping track of assets and liabilities that the user has accrued through their interaction with integrated products. It is via the margin account that a user's deposits as construed as collateral against which the user can borrow or take other risk positions. Margin accounts keep the protocol safe by providing a liquidation mechanism to cover debts when necessary.

A particular user, identified by a public key, may have multiple margin accounts. These can be named for easy reference. The app allows seamless switching between margin accounts and for transferring assets between margin accounts. From a risk perspective all margin accounts are completely isolated. Liquidations only affect a particular unhealthy account, even if the user being liquidated also owns other margin accounts.


From an accounting perspective, a particular margin account can be viewed as a list of assets A{\cal A} and a list of liabilities L{\cal L}. Margin accounting proceeds in terms of the USD value of these positions.

The assets AA and liabilities LL of the margin account are given by

A=βˆ‘a∈APaA = \sum_{a \in \cal{A}} P_a
L=βˆ‘l∈LPlL = \sum_{l \in \cal{L}} P_l

where​ Paβ‰₯0P_a \geq 0​ and Plβ‰₯0P_l \geq 0​ are the USD values of the corresponding positions. The equity or account value is given by

E=Aβˆ’LE = A - L

​A margin account is required to have a minimum amount of equity in order to be considered healthy. The amount depends on the composition of assets and liabilities. Collateral weights, denoted wa w_a , influence the contribution of assets to weighted collateral, which is given by

Kw=βˆ‘a∈AwaPaK_w = \sum_{a \in \cal{A}} w_a P_a

Liabilities imply a certain amount of required collateral that depends on the size of the liability and the required collateral factor, denoted fl f_l​. The required collateral is given by

Kr=βˆ‘l∈LPlflK_r = \sum_{l \in \cal{L}} { P_l \over f_l }

​The minimum equity condition is captured implicitly through the relationship between these quantities. A margin account is said to be healthy if the collateral-weight-adjusted-equity equals or exceeds the required collateral. That is, healthy accounts satisfy

Kwβˆ’Lβ‰₯KrK_w - L \geq K_r

​Otherwise the account is considered unhealthy and therefore subject to liquidation.

The following metrics are also used throughout the app and SDK to shed light on the state of a margin account:

Leverage is defined as

leverage=AAβˆ’L{\rm leverage} = { A \over A - L }

​Although a useful quantity when considering a portfolio, it does not connect directly with account health. A related quantity that does is the adjusted leverage, given by

adjustedΒ leverage=KwKwβˆ’(L+Kr){\rm adjusted\ leverage} = { K_w \over K_w - (L + K_r) }

The adjusted leverage is defined to be zero when KwK_w​ is zero and there are no liabilities, and to be infinity when Kw≀L+KrK_w \leq L + K_r.​

The adjusted leverage is equal to one when an account has assets but no liabilities, and increases to infinity at the liquidation threshold.

The account risk indicator is displayed prominently in the app. Account risk is defined to be

ρ=L+KrKw\rho = { L + K_r \over K_w }

If KwK_w​ is zero the account risk is zero if there are no liabilities, or infinity if there are.

The account risk indicator is zero for an account with no liabilities, and increases to one at the liquidation threshold.

The app will not allow a user to put their margin account into an unhealthy state or into a state very close to liquidation. This guard is called the setup check. The app only allows a user to take an action that increases the risk indicator for their account if the account would still be healthy with double the required collateral after the action is completed.

This risk indicator has a direct connection to the change in value of collateral assets that would bring an account to the liquidation threshold. Let rar_a​ denote the return on collateral asset aa. We can define the collateral-weighted return as:

R=βˆ‘a∈AwaPaKwraR=\sum_{a \in \cal {A}} {w_a P_a \over K_w} r_a

​If the risk indicator is ρ\rho​ then the collateral-weighted return that would bring the account to the liquidation threshold is:

R=Οβˆ’1R = \rho - 1

For example, suppose that a user has a USD loan backed by mSOL collateral. If the account risk indicator is 0.90.9​, then a 10%10\% decreased in the price of mSOL will bring the account to the liquidation threshold.

The amount of adjusted equity in excess of required collateral is called available collateral:

availableΒ collateral=(Kwβˆ’L)βˆ’Kr{\rm available\ collateral} = (K_w - L) - K_r

​Available collateral is a USD quantity that expresses how close to liquidation a margin account is. The liquidation threshold lies at zero available collateral. See the liquidation page for further details.

Last updated