Crypto Whale Alerts
Real-time cryptocurrency whale tracker for AI agents and crypto traders. Monitors large on-chain transactions on Bitcoin, Ethereum, and major altcoins, tracks known whale wallets (exchanges, institutions, smart money), detects accumulation/distribution patterns, and generates actionable alerts. Commands: whale_alerts.py scan Scan for whale transactions above threshold whale_alerts.py summary Get whale activity summary whale_alerts.py watch List tracked whale wallet addresses whale_alerts.py set-threshold Set minimum USD threshold Environment: WHALE_MIN_USD (default 100000), WHALE_COOLDOWN (default 60 min). Python 3.9+, zero external dependencies. Uses mock data structure that maps to real Etherscan/Blockchair API responses in production. Whale classification: INFLOW (exchange receiving, potential selling pressure) vs OUTFLOW (cold storage, accumulation signal). Watchlist includes Binance, Coinbase, Grayscale, and notable smart money addresses.
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.
Related skills
- Downloads
- 917All time
- Security audit
- Pass
- Last updated
- 6mo ago
- Current version
- v1.0.0
- License
- MIT-0
