> ## 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. Ratings are updated every 5 minutes using a multi-factor model that tracks price deviation, liquidity, volatility, persistence, oracle divergence, and cross-chain spread.

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 5 minutes based on weighted signals:

| Signal                   | Weight | Description                                                                |
| ------------------------ | ------ | -------------------------------------------------------------------------- |
| Price Deviation (5m)     | 30%    | Distance from peg; 5% deviation = maximum rating                           |
| Slippage (\$100k)        | 20%    | On-chain trade slippage; higher = thinner liquidity                        |
| Persistence (50bp, 60m)  | 18%    | Minutes exceeding 0.5% deviation in last hour                              |
| Persistence (100bp, 60m) | 12%    | Minutes exceeding 1.0% deviation in last hour                              |
| Volatility Burst         | 10%    | Triggered when recent volatility > 2x baseline                             |
| *Headroom*               | *10%*  | *Reserved for future signals (oracle deviation, cross-chain spread, etc.)* |

### Risk Tiers

| Tier       | Rating | Interpretation                                  |
| ---------- | ------ | ----------------------------------------------- |
| `critical` | >= 80  | Severe depeg risk, immediate attention required |
| `warning`  | 60-79  | Elevated risk, close monitoring needed          |
| `watch`    | 40-59  | Early stress signals, track trends              |
| `ok`       | \< 40  | 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`, `pol`, `opt`, `base`, `bsc`, `linea`

***

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