Crypto Whale Alerts

Tracks large on-chain transactions and whale wallet movements to generate actionable crypto trading alerts.

Configuration

# Set minimum transaction threshold in USD
export WHALE_MIN_USD=500000

# Set alert cooldown period in minutes
export WHALE_COOLDOWN=30

Commands

# Scan for whale transactions above threshold
python scripts/whale_alerts.py scan

# Get whale activity summary
python scripts/whale_alerts.py summary

# View tracked whale wallet addresses
python scripts/whale_alerts.py watch

# Change minimum threshold
python scripts/whale_alerts.py set-threshold 250000

Alert Interpretation

• INFLOW (green): Large transaction into exchange hot wallet
• Could indicate imminent selling pressure
• Watch for distribution patterns

• OUTFLOW (red): Large transaction from exchange to cold storage
• Could indicate accumulation phase
• Often precedes price increases

Watchlist

Includes major exchange hot wallets, institutional custodians, and notable smart money addresses:

• Binance Hot (multiple wallets)
• Coinbase Custody
• Grayscale Trust wallets
• DeFi protocol treasuries

Production Integration

For live data, connect to:

• Etherscan API for Ethereum transactions
• Blockchair API for multi-chain coverage
• Glassnode for whale wallet labels

The script uses mock data with real field structure for easy API integration.