Skip to main content

How to Understand Vault APYs

It is a standard on Defi Space to estimate returns through APY and APR, and Yearn also does so. However, different calculations depend on the yVault underlying asset: one for Curve.Finance LP Tokens and another for non-curve assets. For a simpler version, check our APYs medium article or the infographic at the end of the page. The following sections will show how each is calculated:

Non-curve assets​

The estimated returns are displayed on yearn.fi this way:

image

Where the definition of each one is:

  • Gross APR: Vault total APR before deducted fees
  • Net APY: Vault considered APY. If the network is ETH mainnet, this will show the Monthly APY, as the harvests are not that frequent. On the other hand, if the network is Fantom, then the Weekly API is chosen, as the harvests are more frequent.
  • Weekly APY: Calculated considering the yVault price share difference in the last seven days
  • Monthly APY: Calculated considering the yVault price share difference in the last 30 days
  • Inception APY: Calculated considering the yVault price share difference since inception

The actual code can be found on this repo: https://github.com/yearn/yearn-exporter/tree/master/yearn/apy

image

The file that contains the calculation for the most recent version of the yVaults is this one: https://github.com/yearn/yearn-exporter/blob/master/yearn/apy/v2.py

Curve assets​

The estimated returns are displayed on yearn.fi this way:

image

Where the definition of each one is:

  • Pool APY: APY is calculated considering the change in the “virtual price” of the curve.finance LP token in the last seven days.
  • Bonus Rewards APR: Rewards are usually given by the token owner. IE frax curve pools also offer frax as a reward. The APY if the token were sold at the current price.
  • Base CRV APR:The APR from the CRV emissions this curve pool gets.
  • Boost: Multiplier from staked veCRV, ranging from 1x to 2.5x
  • Convex APR: APR when the yVault strategy is depositing the curve.finance LP tokens into Convex Finance
  • Gross APR: Vault total APR before deducted fees
  • Net APY: Vault current APY, after deducting the fees

The actual code can be found on this repo: https://github.com/yearn/yearn-exporter/tree/master/yearn/apy/curve

image

The file that contains the calculation for the most recent version of the yVaults is this one: https://github.com/yearn/yearn-exporter/blob/master/yearn/apy/curve/simple.py

Notes​

  • When the active strategy of a yVault uses Convex Finance, and the streaming of the rewards is frozen at Convex, yearn.fi Net APY will show 0% until the streaming is resumed.

image

More details about rewards streaming on Convex Finance

  • When there is a spike of transactions in a pool, the “Pool APY” will reflect it for a week, as the fees will be added to the “virtual price” of this pool, and the calculation takes the last seven days into account.

Infographic​

image