Liquidity Monitor 💧

Real-time DEX liquidity pool monitoring with impermanent loss calculation and LP yield estimation.

Feature List

🔍 Pool Discovery & Monitoring

• Search liquidity pools by token pair across major DEXes
• Monitor pool TVL (Total Value Locked) in real-time
• Track liquidity depth changes over time
• Alert when liquidity drops below threshold

📊 Impermanent Loss Calculator

• Calculate IL for any price movement scenario
• Compare IL vs holding vs LP yield
• Model IL across different price ranges (for concentrated liquidity)
• Historical IL analysis for existing positions

💰 LP Yield Calculator

• Estimate APR/APY from trading fees
• Include farming rewards in yield calculation
• Project earnings over custom time periods
• Compare yields across pools and DEXes

⚠️ Alert System

• Liquidity removal alerts (rug pull detection)
• Large swap impact warnings
• Pool ratio imbalance notifications
• TVL drop percentage triggers

📈 Analytics & Reports

• Pool health score (0-100)
• Volume-to-liquidity ratio analysis
• Top liquidity providers tracking
• HTML dashboard generation

Usage

Monitor a Pool

bash scripts/liquidity-monitor.sh monitor \
  --dex uniswap-v2 \
  --pair "ETH/USDC" \
  --chain ethereum

Calculate Impermanent Loss

bash scripts/liquidity-monitor.sh impermanent-loss \
  --token-a ETH \
  --token-b USDC \
  --entry-price 3000 \
  --current-price 4500

Estimate LP Yield

bash scripts/liquidity-monitor.sh yield \
  --pool-address "0xB4e16d0168e52d35CaCD2c6185b44281Ec28C9Dc" \
  --amount 10000 \
  --period 30

Pool Health Check

bash scripts/liquidity-monitor.sh health \
  --dex raydium \
  --pair "SOL/USDC" \
  --chain solana

Generate Dashboard

bash scripts/liquidity-monitor.sh dashboard \
  --pools-file my-pools.json \
  --output liquidity-dashboard.html

Supported DEXes

EVM Chains:

• Uniswap V2 / V3 (Ethereum, Polygon, Arbitrum, Optimism, Base)
• SushiSwap (Multi-chain)
• PancakeSwap (BSC, Ethereum)
• Curve Finance (Ethereum, Polygon, Arbitrum)

Solana:

• Raydium (AMM & CLMM)
• Orca (Whirlpools)
• Meteora

Impermanent Loss Reference Table

Price Change	IL (50/50 Pool)	Equivalent Loss
±25%	0.6%	$6 per $1,000
±50%	2.0%	$20 per $1,000
±75%	3.8%	$38 per $1,000
±100% (2x)	5.7%	$57 per $1,000
±200% (3x)	13.4%	$134 per $1,000
±400% (5x)	25.5%	$255 per $1,000

Pool Health Score Criteria

Factor	Weight	Description
TVL Stability	25%	How stable is the TVL over 7 days
Volume/TVL Ratio	20%	Higher ratio = better fee generation
LP Count	15%	More LPs = less concentration risk
Age	15%	Older pools are generally safer
Top LP %	15%	Lower concentration = better
Smart Contract Audit	10%	Known audited DEX protocols score higher