Notional V3 User Docs
  • Product Guides
    • Lending
    • Fixed Rate Lending
    • Providing Liquidity
    • Borrowing
    • Fixed Rate Borrowing
    • Leveraged Liquidity
    • Leveraged Yield Farming
    • Leveraged Points Farming
    • Leveraged Pendle PTs
  • Risk Framework
  • Developer Docs
  • šŸ¦Prime Money Market
    • Overview
    • Interest Rate Model
    • Borrow Fees
  • šŸ’øfCash
    • What is fCash
    • Using fCash
    • fCash Maturity
  • šŸ’¹Trading fCash
    • Transaction Fees
    • Exiting Early
    • Interest Rate Risk
  • šŸ’°Borrower Resources
    • Loan to Value (LTV)
    • Health Factor
    • Liquidation
    • Max LTV Table
  • 🚰Fixed Rate Liquidity Pools
    • What are Fixed Rate Liquidity Pools
    • Fixed Rate Liquidity Pool Mechanics
  • šŸŖ™nTokens
    • What are nTokens
    • nToken Mechanics
      • nToken Portfolio
      • Minting nTokens
      • Redeeming nTokens
    • nToken Returns
    • nToken Risks
  • ⚔Leveraged Vaults
    • What are Leveraged Vaults
    • Entering and Exiting a Vault
    • Liquidation
    • Settlement
    • Vault Returns
    • Vault Risks
    • Vault FAQs
  • āš–ļøGovernance
    • NOTE
    • NOTE Staking
  • Smart Contracts
    • Deployments (Mainnet)
    • Deployments (Arbitrum)
    • Audits
    • Bug Bounty
Powered by GitBook
On this page
  • Leverage ratios
  • Liquidation mechanics
  • Example liquidation
  1. Leveraged Vaults

Liquidation

PreviousEntering and Exiting a VaultNextSettlement

Last updated 1 year ago

Leverage ratios

Every strategy vault enforces a maximum leverage ratio and every user has a leverage ratio that is a function of the value of their assets and the value of their debt. If the value of a user's assets falls and their leverage ratio breaches the max ratio, they can be liquidated.

The leverage ratio is calculated as the difference between the user's vaultShareValue (their total assets) and their debt, divided by the value of their debt.

leverageĀ ratio=vaultShareValueāˆ’debtdebtleverage { \ } ratio = \frac{vaultShareValue - debt}{debt}leverageĀ ratio=debtvaultShareValueāˆ’debt​

By this metric, the closer to 0 the leverage ratio is, the riskier the position. Upon liquidation, a user's leverage ratio will increase and their position will become less risky.

Liquidation mechanics

In the event of liquidation, a liquidator can purchase a portion of the user's vaultShares at a discount to their value for cash that is used to pay down the user's debt. Economic liquidation details are determined by the following variables that are set on a per-vault basis:

  • Maximum leverage ratio: This is the leverage ratio that will trigger a liquidation upon breach.

  • Target leverage ratio: The target leverage ratio is lower (less risky) than the maximum leverage ratio, and is used within the liquidation function to determine how much of a user's vaultShares the liquidator is eligible to purchase.

  • Liquidation bonus: The bonus that the liquidator receives during liquidation.

  • Minimum debt size: The minimum amount of debt a user can hold. No liquidation can bring an account below the minimum debt size unless the liquidation fully zeroes out the user's debt.

Example liquidation

Consider the following vault and account:

  • Maximum leverage ratio: 0.2

  • Target leverage ratio: 0.4

  • Liquidation bonus: 5%

  • Minimum debt size: 50,000 USDC

  • Value per vaultShare: 1 USDC

  • Account vaultShares: 590,000

  • Account debt: 500,000 USDC

  • Account leverage ratio: 0.18

This account is over-levered and eligible for liquidation. The max amount of vaultShares that the liquidator can purchase (math obscured for simplicity) is 330,000 for a price of 314,285 USDC. This liquidation will return the account to the target leverage ratio of 0.4 and it will leave the account with a debt of 185,715 USDC so the account will not be in violation of the minimum debt size.

To illustrate how the minimum debt size comes into play during liquidations, let's consider that the account instead held 59,000 vaultShares vs 50,000 USDC debt. In this case, returning the account to a leverage ratio of 0.4 would leave it with a debt of only 18,571 USDC. This amount is below the minimum debt threshold.

In this case, the liquidator would be required to zero out the account's debt completely. So the liquidator would be allowed to purchase 52,500 vault shares for 50,000 USDC, leaving the liquidated account with 6,500 vaultShares and no debt.

⚔