A margin account is like a ledger within a ledger, keeping track of assets and liabilities that the user has accrued through their interaction with integrated products and services. 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
and a list of liabilities
. Margin accounting proceeds in terms of the USD value of these positions.
of the margin account are given by
are the USD values of the corresponding positions. The equity or account value is given by
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
, influence the contribution of assets to weighted collateral, which is given by
Liabilities imply a certain amount of required collateral that depends on the size of the liability and the required collateral factor, denoted
. The required collateral is given by
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
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 usual
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
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
The account risk indicator is zero for an account with no liabilities, and increases to one at the liquidation threshold.
This indicator has a direct connection to the change in value of collateral assets that would bring an account to the liquidation threshold. Let
denote the return on collateral asset
. We can define the collateral-weighted return as
If the risk indicator is
then the collateral-weighted return that would bring the account to the liquidation threshold is
For example, suppose that a user has a USD loan backed by mSOL collateral. If the account risk indicator is
, then a
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 is a USD quantity that expresses how close to liquidation a margin account is. The liquidation threshold lies at zero available collateral.