Documentation Index

Fetch the complete documentation index at: https://docs.yieldo.xyz/llms.txt

Use this file to discover all available pages before exploring further.

​

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