J
J
Jet Protocol
Search…
Margin accounts
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
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 usual
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.
This 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.
Copy link