> ## Documentation Index
> Fetch the complete documentation index at: https://docs.webacy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Depeg Monitor data dictionary

> Definitions for every column and filter on the Depeg Monitor overview table — risk score, grade, peg deviation, supply flow, holder concentration, and more.

What each column and filter means on the overview table.

# Columns

| Column       | Meaning                                                                                                                                                       |
| :----------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Symbol**   | Token symbol with type badge (YIELD, RWA, BRIDGED, GOLD). Hover for market cap. Small line shows e.g. "\$1.2B mcap" when available.                           |
| **Name**     | Display name of the token/project.                                                                                                                            |
| **Chain**    | EVM chain (eth, arbitrum, optimism, base, polygon, bsc).                                                                                                      |
| **Currency** | Peg currency: USD, EUR, JPY, XAU (gold).                                                                                                                      |
| **Score**    | Risk score 0–100. Higher = higher depeg risk. Hover for score drivers. See [How the score is computed](https://depeg-monitor.webacy.co/docs/depeg-scoring).   |
| **Mcap**     | Market cap in USD (from market-data aggregators when available). Used for market sizing. Tooltip may show circulating supply and mcap ≈ price × supply check. |
| **Vol 24h**  | 24h trading volume in USD (from market-data aggregators). Size-of-market and turnover context.                                                                |
| **Trend**    | 48h score sparkline. Red ▲ = risk increased; green ▼ = risk decreased. Δ = last score vs recent baseline.                                                     |
| **Liq**      | DEX liquidity tier: ████ high (>\$100k/hr), ███ medium, ██ low, █ very low. From 60m DEX volume.                                                              |
| **Tier**     | Risk tier: critical (70+), warning (50+), watch (25+), ok (\<25). ⚡ = volatility burst.                                                                       |
| **Price**    | Current market price in USD (5m VWAP from DEX; may be corrected by reference market feeds).                                                                   |
| **Peg**      | Target USD value. USD = \$1, EUR ≈ \$1.08, etc. ↕ = expected range for yield/RWA tokens.                                                                      |
| **% Off**    | \|price ÷ peg − 1\| × 100. For yield tokens in range we show "+X% (in range)". ⚠️ = >50% (possible data issue).                                               |
| **Address**  | Contract address (truncated). Copy / explorer links available.                                                                                                |
| **Last**     | Timestamp of last snapshot used for this row.                                                                                                                 |

# Filters

| Filter                       | Meaning                                                                |
| :--------------------------- | :--------------------------------------------------------------------- |
| **Filter by type (tags)**    | All, Standard, Yield, RWA, Gold, Bridged. Filters by token label/type. |
| **Chain**                    | Restrict to one chain (eth, arbitrum, optimism, base, polygon, bsc).   |
| **Currency**                 | Restrict to peg currency (USD, EUR, JPY, XAU).                         |
| **Tier**                     | Show only critical, warning, watch, or clear.                          |
| **minScore**                 | Minimum risk score (0–100).                                            |
| **Liq: high / medium / low** | Filter by liquidity tier. "Low" includes very\_low.                    |
| **Search (q)**               | Text search in symbol, name, and address.                              |

# Vault Output Fields

| Field                            | Type               | Meaning                                                                                                                                                                             |
| :------------------------------- | :----------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **monitoring\_status**           | string enum        | `active` \| `watch` \| `legacy` \| `deprecated`. Derived from TVL, trend, and protocol deprecation status.                                                                          |
| **actionability\_class**         | string             | Dominant risk class driving the score: `smart_contract` \| `liquidity_lock` \| `governance` \| `market_conditions`.                                                                 |
| **actionability\_action**        | string             | Recommended action verb: `monitor` \| `watch` \| `review` \| `reduce` \| `plan` \| `exit`.                                                                                          |
| **actionability\_detail**        | string             | One-line guidance based on dominant class and tier (e.g. "Smart contract risk is elevated — review audit history and consider reducing exposure").                                  |
| **actionability\_class\_scores** | object             | Scores for each of the four risk classes: `{smart_contract, liquidity_lock, governance, market_conditions}`. Each value is 0–100.                                                   |
| **data\_as\_of**                 | string (ISO 8601)  | Timestamp when this vault was last scored. The UI shows an amber ⚠ staleness indicator when the value is more than 48 hours old.                                                    |
| **last\_audit\_date**            | string (ISO date)  | Most recent security audit date for this protocol.                                                                                                                                  |
| **audit\_firms**                 | string\[]          | Audit firms that have reviewed this protocol.                                                                                                                                       |
| **ts\_feature\_tags**            | string\[]          | Vault architecture tags (e.g. `euler_earn_like`, `pendle_pt`, `yearn_v3_like`). Used for architecture-specific scoring rules.                                                       |
| **days\_since\_harvest**         | integer (nullable) | Days since last `harvest()` keeper call for strategy/keeper vaults (Yearn V2/V3, Harvest Finance, etc.). `null` when `last_harvest_at` is not available from on-chain harvest data. |
| **harvest\_slow**                | risk flag          | Strategy vault hasn't harvested in 30–60 days; mild yield drag accumulating.                                                                                                        |
| **harvest\_stale**               | risk flag          | Strategy vault hasn't harvested in 60–90 days; moderate yield drag.                                                                                                                 |
| **harvest\_dormant**             | risk flag          | Strategy vault hasn't harvested in 90+ days; treated as fully inactive.                                                                                                             |

# CEX Price Feed Fields

| Field                        | Type             | Meaning                                                                              |
| :--------------------------- | :--------------- | :----------------------------------------------------------------------------------- |
| **cex\_price\_usd**          | float (nullable) | CEX-derived price for USDT/USDC/DAI/FDUSD via BTC cross-rate. Null for other tokens. |
| **cex\_price\_deviation**    | float (nullable) | Absolute deviation from peg from CEX price source.                                   |
| **price\_source\_agreement** | float (nullable) | Fractional divergence between DEX and CEX price (0 = identical, 1 = 100% apart).     |

# Supply Flow Fields

| Field                  | Type             | Meaning                                                         |
| :--------------------- | :--------------- | :-------------------------------------------------------------- |
| **organic\_net\_24h**  | float (nullable) | Net native supply change excluding bridge flows.                |
| **bridge\_flow\_pct**  | float (nullable) | Fraction of supply change from bridge activity.                 |
| **bridged\_fraction**  | float (nullable) | Fraction of total supply that is bridged.                       |
| **has\_bridged\_data** | boolean          | Whether a bridged-supply breakdown is available for this token. |

# Stablecoin / Depeg Scoring Driver Fields

| Field                               | Type              | Meaning                                                                                                                                                                                                        |
| :---------------------------------- | :---------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **reserve\_attestation\_date**      | string (ISO date) | Date of the most recent reserve attestation for this issuer. Present as a meta-driver in the `drivers` array.                                                                                                  |
| **reserve\_attestation\_lag\_days** | integer           | Days since the last reserve attestation. Scores 0 for \<30 days, ramping to the maximum penalty at 180+ days.                                                                                                  |
| **corroboration\_gated**            | flag              | Present in `drivers` when weak signals (`pool_balance_drift`, `single_source`, `blacklist_activity`) were capped at 40% weight due to a lack of corroborating signals.                                         |
| **confluence\_demotion**            | flag              | Present in `drivers` when the tier was demoted from warning → watch because fewer than 2 strong signals (normalized ≥0.10) were present.                                                                       |
| **supply\_spike\_gated**            | meta-driver flag  | Present in `drivers` when `supply_spike` signal was capped at 20% weight due to being a first-appearance spike with no prior snapshot confirmation. Full weight restores after 2+ consecutive spike snapshots. |
| **bridge\_flow\_spike**             | meta-driver flag  | Supply spike capped at 50% weight; >80% of spike explained by L2 bridge inflows.                                                                                                                               |
| **cex\_only\_stress**               | meta-driver flag  | CEX shows stress (>20bp) but DEX is calm; scored at 0 but flagged for investigation.                                                                                                                           |

# Alert Payload Fields

| Field              | Type   | Meaning                                                       |
| :----------------- | :----- | :------------------------------------------------------------ |
| **why\_now**       | string | Human-readable summary of what changed to trigger this alert. |
| **signal\_deltas** | object | Per-signal changes versus the prior snapshot.                 |
| **tier\_change**   | string | Tier transition if one occurred (e.g. `watch → warning`).     |
