> ## 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

> Use the Webacy depeg monitor endpoints to track stablecoin and RWA peg deviations in real time, with thresholds, severity bands, and event history.

## Overview

The Depeg Monitor gives you real-time risk ratings for 600+ pegged tokens (stablecoins, RWAs, gold-backed, yield-bearing) across 7 EVM chains (Ethereum, Arbitrum, Base, BNB Chain, Polygon, Optimism, Avalanche) and Solana. Ratings are updated every 20 minutes using a multi-factor model that tracks price deviation, liquidity depth, persistence, volatility, oracle divergence, cross-chain spread, and leading on-chain supply/redemption-flow signals.

Coverage is deepest on Ethereum, BNB Chain, Arbitrum, Base, Polygon, and Optimism; Avalanche and Solana carry a smaller token set.

Each response includes a standard `risk` field in the same format used by all other Webacy risk endpoints (Threat Risks, Token Analysis, Pool Analysis), so you can consume depeg risk data using the same schema as token and pool risk.

## Endpoints

<CardGroup cols={2}>
  <Card title="List Pegged Tokens" icon="list" href="/api-reference/depeg-monitor/list-pegged-tokens-with-depeg-risk">
    Paginated list of all stablecoins and RWAs with depeg risk ratings, filtering, sorting, and ecosystem aggregates
  </Card>

  <Card title="Token Detail" icon="magnifying-glass-chart" href="/api-reference/depeg-monitor/get-depeg-risk-detail-for-a-pegged-token">
    Full depeg snapshot with 50+ metrics, historical time series, and depeg event history for a specific token
  </Card>
</CardGroup>

***

## Key Concepts

### Risk Rating (0-100)

You get a composite risk rating for each token every 20 minutes from a weighted, multi-factor model. Weights are relative; when a signal has no data for a token (e.g. a CEX cross-rate for a DEX-only token) it is skipped and the remaining weights are renormalized.

| Signal | Weight | Description |
| - | - | - |
| Price Deviation (5m) | 31% | Distance from peg; 5% deviation = maximum rating |
| Persistence (50bp, 60m) | 14% | Minutes exceeding 0.5% deviation in last hour |
| Persistence (100bp, 60m) | 11% | Minutes exceeding 1.0% deviation in last hour |
| Liquidity Depth | 10% | DEX pool depth / ±2% order-book depth — thinner depth raises risk |
| CEX Cross-Rate Deviation | 6% | Centralized-venue cross-rate (CEX-listed tokens only) |
| Volatility Burst | 5% | Triggered when recent volatility exceeds baseline |
| Cross-Chain Spread (5m) | 5% | Price dispersion of the same token across chains |
| Supply Spike (leading) | 5% | Anomalous minting — leading exploit signal |
| Redemption Velocity (leading) | 5% | Concentrated redemption/burn drain — leading run signal |
| Corroborating signals | \~8% | Oracle deviation & staleness, liquidity decay, volume anomaly, max drawdown, price-source disagreement, executable liquidity |

### Risk Tiers

| Tier | Rating | Interpretation |
| - | - | - |
| `critical` | >= 70 | Severe depeg risk, immediate attention required |
| `warning` | 50-69 | Elevated risk, close monitoring needed |
| `watch` | 25-49 | Early stress signals, track trends |
| `ok` | \< 25 | Normal conditions, low risk |
| `premium` | N/A | Token trading above peg (positive deviation) |

### Standard Risk Response

The `risk` field on each token follows the same structure used by the Token Analysis and Pool Analysis endpoints:

```json theme={null}
{
  "risk": {
    "count": 2,
    "medium": 1,
    "high": 1,
    "overallRisk": 65,
    "issues": [
      {
        "score": 65,
        "tags": [
          {
            "key": "depeg_price_deviation",
            "name": "Price Deviation",
            "type": "depegRisk",
            "severity": 5.3,
            "description": "Token price deviating from its peg value"
          }
        ],
        "categories": {
          "price_stability": {
            "name": "Price Stability",
            "tags": { "depeg_price_deviation": true }
          }
        }
      }
    ]
  }
}
```

### Supported Chains

`eth`, `arb`, `base`, `bsc`, `pol`, `opt`, `avax`, `solana`

Solana-native stablecoins (e.g. USDC, USDT, PYUSD) are market-priced against a \$1 peg through the same aggregator and scoring path as EVM tokens — pass `chain=solana` with the token's base58 mint address.

***

## Common Use Cases

| Use Case | Endpoint | Parameters |
| - | - | - |
| Dashboard overview | `GET /rwa` | `sort=score&order=desc&pageSize=50` |
| Filter by chain | `GET /rwa` | `chain=eth&tier=ok&sort=market_cap_usd&order=desc` |
| Search for a token | `GET /rwa` | `q=USDC` |
| Token detail with 7-day history | `GET /rwa/{address}` | `chain=eth&hours=168` |
| Graveyard (dead tokens) | `GET /rwa` | `collapsedOnly=true` |
| High-cap stablecoins only | `GET /rwa` | `minMcap=1000000000&tags=standard` |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.