Synthetix Docs
  • User Docs
  • Synthetix Exchange
  • Leveraged Tokens
  • For Developers
  • Orientation
  • Synthetix Overview
  • Development Progress
  • V3 FAQ
  • For Developers
    • Technical Architecture
    • Quick Start
      • Base Quickstart
    • Smart Contracts
    • Data Platform
    • Data Dictionary
    • Addresses + ABIs
    • Deployment Info
      • Mainnet
      • Sepolia
      • Sepolia Carina
      • Optimism Mainnet
      • Base Mainnet Andromeda
      • Base Sepolia Andromeda
      • Arbitrum Mainnet
      • Arbitrum Sepolia
    • Smart Contract Audits
    • Perps Market
    • Spot Market
    • Developer FAQ
  • For Perp Integrators
    • 101
    • Perps V3
    • L1 Perp (BFP)
    • Base Andromeda
    • Perps Python SDK
    • Perps V3 Keepers
  • For Liquidity Integrators
    • Creating Accounts
    • Delegating Collateral
      • Liquidity Pools
    • Liquidity Positions
      • Minting and Burning snxUSD
      • Position Liquidations
    • Base LP Guide
  • For Liquidity Pool Managers
    • Creating and Configuring Pools and Vaults
    • Collateral Vaults
      • Vault Liquidations
    • Rewards Distributors
    • Credit and Debt Distribution
  • For Derivatives Market Builders
    • Build on v3
    • Market Development Guide
    • Build on v3 FAQ
    • Operating a Market
    • Registering a Market
  • For Governance Participants
    • Synthetix Governance
    • Elections
  • For Designers
    • Design Resources
Powered by GitBook
On this page
  1. For Liquidity Pool Managers
  2. Collateral Vaults

Vault Liquidations

PreviousCollateral VaultsNextRewards Distributors

Last updated 1 year ago

It is possible for an entire vault to be liquidated. This may occur when the ratio of the value of all the collateral it contains relative to the value of all of the debt it’s responsible for drops below the Liquidation C-Ratio for its corresponding collateral type. This is a scenario where sequentially performing on each of the liquidity positions would result in the last remaining position still having a collateralization ratio below the Liquidation C-Ratio.

In this case, anyone can wind down this vault by repaying some or all of its debt with snxUSD and receiving a proportional share of the collateral held in the vault. Because this can occur the moment the vault's C-Ratio drops below the Liquidation C-Ratio (while still above 100%), liquidators are incentivized to restore the health of the system by receiving collateral worth more than the debt they are repaying. The liquidated collateral is seized from all of the liquidity positions in the vault pro-rata.

To perform a vault liquidation, anyone can call the liquidateVault function. The poolId and collateralType parameters specify the vault to liquidate. The liquidateAsAccountId parameter specifies an account which should receive the collateral. (It can then be delegated to a pool, or retrieved from the system using the withdraw function.) The maxUsd parameter specifies the maximum amount of snxUSD that will be transferred from msg.sender to perform the liquidation. If maxUsd is less than the total debt carried by the vault, a partial liquidation will occur.

liquidations