____                  __                        
/ __ \___ _ ____ ___  / /____  ____  ____  ____ _
/ / / / _ \ / ___/ __ \/ __/ _ \/ __ \/ __ \/ __ `/
/ /_/ /  __/ /  / /_/ / /_/  __/ /_/ / / / / /_/ / 
\____/\___/_/   \____/\__/\___/\____/_/ /_/\__, /  
                                          /____/   

depegmon

Stablecoin Depeg Monitor — track stablecoin prices, detect depeg events, assess risk, monitor across chains.

What is a stablecoin depeg?

A stablecoin aims to maintain a 1:1 peg with a reference asset (usually USD). A depeg occurs when the price deviates significantly from $1.00. This can signal liquidity crises, collateral problems, or loss of confidence. The UST collapse of May 2022 wiped out ~$40B in value — early detection matters.

Severity	Deviation	Meaning
✅ Pegged	< 0.5%	Normal operation
⚠️ Warning	0.5% – 2.0%	Monitor closely
🚨 Critical	> 2.0%	Potential depeg event

Tracked Stablecoins

Coin	Symbol	Type	Description
Tether	USDT	Fiat-backed	Largest stablecoin by market cap
USD Coin	USDC	Fiat-backed	Issued by Circle/Coinbase
DAI	DAI	Crypto-backed	Decentralized, MakerDAO
Frax	FRAX	Crypto-backed	Fractional-algorithmic
First Digital USD	FDUSD	Fiat-backed	First Digital Labs
Ethena USDe	USDe	Synthetic	Delta-hedged synthetic dollar
Binance USD	BUSD	Fiat-backed	Binance/Paxos (winding down)
TrueUSD	TUSD	Fiat-backed	Archblock
Paxos Standard	PAX	Fiat-backed	Paxos Trust
Gemini Dollar	GUSD	Fiat-backed	Gemini Trust

Install

pip install -r requirements.txt

Usage

status — All tracked stablecoins

python depegmon.py status

Name                 Symbol       Price     Dev%     24h%         MCap  Vol/MCap Status
----------------------------------------------------------------------------------------------
Tether               USDT    $1.0002    +0.020%   +0.01%   $110.50B     3.21% ✅ pegged
USD Coin             USDC    $0.9998    -0.020%   -0.01%    $33.20B     2.15% ✅ pegged
Dai                  DAI     $1.0001    +0.010%   +0.02%     $5.30B     1.89% ✅ pegged

alerts — Only depeg warnings

python depegmon.py alerts --threshold 0.005

⚠️  Stablecoins exceeding 0.50% depeg threshold:

Name                 Symbol       Price     Dev%     24h%         MCap  Vol/MCap Status
----------------------------------------------------------------------------------------------
Ethena USDe          USDe    $0.9943    -0.570%   -0.45%     $2.10B    12.30% ⚠️  warning

history — 30-day price history

python depegmon.py history tether

Price history for tether (30d)
Date                   Price      Dev% Severity  
-------------------------------------------------------
2025-06-01 00:00       $1.000200  +0.020% info     
2025-06-15 00:00       $0.999500  -0.050% info     
2025-06-23 00:00       $1.000100  +0.010% info     

30d Summary: min=$0.999500 max=$1.000200 avg=$0.999933 depeg_events=0

watch — Continuous monitoring

python depegmon.py watch --interval 60 --threshold 0.005

👁️  Watching stablecoins every 60s (threshold=0.50%)
Press Ctrl+C to stop.

[14:30:01] ✅ All stablecoins within 0.50% peg threshold
[14:31:01] 🚨 DEPEG ALERT — 1 coin(s) off peg:
  ⚠️ USDe: $0.9943 (-0.570%) [warning]

risk — Risk assessment

python depegmon.py risk

Name                 Type               Price         MCap     Dev%   Risk Level
------------------------------------------------------------------------------------------
Ethena USDe          synthetic     $0.9943     $2.10B  -0.570%  67.2  HIGH
Binance USD          fiat-backed   $1.0001     $0.50B  +0.010%  42.1  MEDIUM
DAI                  crypto-backed $1.0001     $5.30B  +0.010%  36.5  MEDIUM
Tether               fiat-backed   $1.0002   $110.50B  +0.020%  18.1  LOW

compare — Side-by-side comparison

python depegmon.py compare tether usd-coin

                  USDT  vs  USDC
--------------------------------------------------
           Price $1.0002       vs  $0.9998      
      Deviation% +0.0200%      vs  -0.0200%     
     24h Change% +0.0100%      vs  -0.0100%     
      Market Cap 110.50        vs  33.20        
        Vol/MCap 3.21%         vs  2.15%        
       Risk Score 18.1         vs  18.5         

chains — Stablecoin TVL by chain

python depegmon.py chains

Chain                Stablecoin TVL
--------------------------------------
Ethereum                       $78.32B
Tron                           $55.10B
BSC                             $4.20B
Arbitrum                        $3.15B

top — Top stablecoins by market cap

python depegmon.py top -n 5

Global flags

Flag	Description
--json	Output as JSON
--threshold N	Depeg threshold (default 0.005 = 0.5%)
--format table/csv	Output format
--interval N	Poll interval for watch mode (default 60s)

API Sources

API	Endpoint	Data
CoinGecko	/coins/markets	Prices, market cap, volume
CoinGecko	/coins/{id}/market_chart	30-day price history
DeFiLlama	/stablecoins	Stablecoin overview
DeFiLlama	/stablecoinchains	Chain TVL distribution

All APIs are free, no keys required. 2-minute file cache, 1.5s rate limiting, 3x retry with backoff.

License

MIT