Monitoring Whale Activity
Contents
Overview | Prerequisites | Instructions | Output | Error Handling | Examples | Resources
Overview
Track large cryptocurrency transactions and whale wallet movements across multiple blockchains. Monitor exchange inflows/outflows, manage custom watchlists, and identify known wallets (exchanges, funds, bridges).
Prerequisites
- Install Python 3.8+ with requests library
- Optionally obtain Whale Alert API key (free tier available for live data)
- Verify internet access for API calls
Instructions
Step 1: Navigate to Scripts Directory
cd ${CLAUDE_SKILL_DIR}/scripts
Step 2: Choose a Command
- View recent whale transactions:
python whale_monitor.py recent
- Analyze exchange flows:
python whale_monitor.py flows
- Manage watchlist:
python whale_monitor.py watchlist
- Track specific wallet:
python whale_monitor.py track 0x123...
- Search known labels:
python whale_monitor.py labels --query binance
Alternatively, customize with chain and threshold filters:
python whale_monitor.py recent --chain ethereum
python whale_monitor.py recent --min-value 10000000
python whale_monitor.py watch 0x123... --name "My Whale"
python whale_monitor.py labels --type exchange
Step 3: Interpret Results
Transaction Types:
- DEPOSIT: Sent to exchange (potential selling pressure)
- WITHDRAWAL: From exchange (accumulation signal)
- TRANSFER: Wallet to wallet (whale movement)
Flow Analysis:
- Net positive flow to exchanges = selling pressure
- Net negative flow from exchanges = buying pressure
Output
- Real-time whale transactions with USD values
- Labeled wallets (exchanges, funds, bridges, protocols)
- Exchange inflow/outflow summaries
- Custom watchlist tracking
- JSON, table, or alert format output (
--format json)
Error Handling
See ${CLAUDE_SKILL_DIR}/references/errors.md for:
- API rate limit handling and backoff
- Network timeout recovery
- Invalid address format validation
- Price service fallbacks
Examples
Example 1: View $10M+ whale transactions on Ethereum:
python whale_monitor.py recent --chain ethereum --min-value 10000000
Example 2: Analyze if whales are selling:
python whale_monitor.py flows --chain ethereum
Example 3: Track a known whale wallet:
python whale_monitor.py watch 0x28c6c... --name "Binance Cold"
python whale_monitor.py track 0x28c6c...
Example 4: Export to JSON for further analysis:
python whale_monitor.py recent --format json > whales.json
See ${CLAUDE_SKILL_DIR}/references/examples.md for more usage patterns.
Resources
${CLAUDE_SKILL_DIR}/references/implementation.md - Flow analysis, wallet database, multi-chain details- Whale Alert - Real-time whale transaction API
- Etherscan - Ethereum blockchain explorer
- CoinGecko - Price data API
