Flags
This page explains what flags are and how to read them. If you want the full flag specification including trigger conditions, score penalties, and auto-clear logic, skip to the Technical Deep-Dive.What flags are
Flags are alerts that appear on vault cards when the scoring engine detects something worth your attention. They sit alongside the Yieldo Score rather than replacing it β because a single number canβt always communicate urgency. Some situations require immediate visibility regardless of the underlying score. If a vault is paused right now, you need to know that instantly. Flags provide that layer of real-time signal.Three severity levels
π΄ Critical
Something is wrong right now. Critical flags indicate an active condition that poses an immediate risk to deposited capital. They trigger a score penalty and in some cases the vault may be suspended from appearing in default listings. Critical flags require no interpretation: if you see a red flag, read it carefully before proceeding. Examples:- The vault is currently paused β deposits and withdrawals are blocked
- An emergency withdrawal has been triggered β a sign of a potential exploit or critical failure
- The underlying stablecoin has depegged by more than 4% from its target price
- TVL has dropped more than 20% in a single day β a potential bank run
- The vault has been losing money for 7 or more consecutive days
π‘ Warning
Conditions are elevated or deteriorating. Warning flags donβt mean something is broken β they mean you should pay attention. They carry a smaller score penalty than critical flags and are monitored closely by the scoring engine. Examples:- TVL has dropped more than 10% in a day or 20% over a week
- More than 10% of the vaultβs TVL is queued for withdrawal
- The vaultβs yield is more than 25% below what youβd earn from a simple passive alternative
- More than half the vaultβs yield comes from token incentive emissions
- The average depositor is holding for less than 10 days β elevated mercenary capital signal
π΅ Info
A noteworthy characteristic that is relevant to your decision but not a warning. Info flags carry no score penalty. They appear on the vault detail page, not on the vault card summary. Examples:- The vault launched less than 30 days ago β limited data history
- More than 30% of the vaultβs yield comes from token incentives (classified as Incentivised Yield)
- The vault uses async withdrawals β there will be a waiting period before funds can be claimed
- APY is slightly below the passive benchmark β not dangerous, but worth noting
How flags interact with the score
Critical flags subtract points directly from the final Yieldo Score. The more severe the flag, the larger the penalty. A vault can accumulate multiple flag penalties simultaneously. Warning flags carry smaller penalties. Info flags carry no penalty at all β they exist purely to inform. A vault can score 80+ and still carry an Info flag. This is intentional. An Info flag on a strong vault might mean its yield is partially incentivised, or that it launched recently. Neither of those things makes a well-run vault unsafe β they are just facts worth knowing. The flag system is designed to surface relevant information, not to manufacture concern where none exists.Flags auto-clear when conditions improve
Flags are not permanent marks against a vault. When the triggering condition resolves β the depeg recovers, the TVL stabilises, the withdrawal queue clears β the flag clears automatically. The scoring engine checks conditions continuously and updates flags in near real-time for critical alerts. One exception: Emergency Withdraw flags never auto-clear. A vault that has triggered an emergency shutdown requires manual review before it can be reinstated. This is by design β the circumstances that trigger an emergency shutdown warrant human judgement before a vault is considered safe again.Flag reference summary
| Flag | Severity | Triggered when |
|---|---|---|
| Vault Paused | π΄ Critical | Vault has halted deposits and withdrawals |
| Emergency Withdraw | π΄ Critical | Emergency shutdown event detected |
| Asset Depeg (Severe) | π΄ Critical | Underlying asset >4% from peg |
| TVL Crash | π΄ Critical | TVL drops >20% in 1 day or >40% in 7 days |
| Sustained Negative APY | π΄ Critical | Vault losing money for 7+ consecutive days |
| Capital Flight | π΄ Critical | Less than 50% of capital from 30 days ago remains |
| Asset Depeg (Moderate) | π‘ Warning | Underlying asset 2β4% from peg |
| TVL Drop | π‘ Warning | TVL drops 10β20% in 1 day or 20β40% in 7 days |
| High Incentive Ratio | π‘ Warning | 25β50% of yield from token emissions |
| Below Benchmark | π‘ Warning | APY 25β50% of the passive benchmark |
| Elevated Pending Withdrawals | π‘ Warning | Withdrawal queue is 10β20% of TVL |
| Short Average Holding | π‘ Warning | Average depositor holds for less than 10 days |
| New Vault | π΅ Info | Vault is less than 30 days old |
| Incentivised Yield | π΅ Info | More than 30% of yield from token incentives |
| Async Withdrawals | π΅ Info | Vault uses delayed withdrawal processing |
| Slightly Below Benchmark | π΅ Info | APY 50β80% of the passive benchmark |