Skip to main content
monitoring-whale-activity Track large cryptocurrency transactions and whale wallet movements in real-time.
Use when tracking large holder movements, exchange flows, or wallet activity.
Trigger with phrases like "track whales", "monitor large transfers", "check whale activity", "exchange inflows", or "watch wallet".
npx skills add jeremylongshore/claude-code-plugins-plus-skills --skill monitoring-whale-activity ai automation claude-code devops mcp ai-agents
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 # Specific chain
python whale_monitor.py recent --min-value 10000000 # 10000000: $10M+ only
python whale_monitor.py watch 0x123... --name "My Whale" # Add to watchlist
python whale_monitor.py labels --type exchange # Or use type filter
Step 3: Interpret Results
DEPOSIT: Sent to exchange (potential selling pressure)
WITHDRAWAL: From exchange (accumulation signal)
TRANSFER: Wallet to wallet (whale movement)
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 # 10000000 = 10M limit
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 detailsWhale Alert - Real-time whale transaction APIEtherscan - Ethereum blockchain explorerCoinGecko - Price data API Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Set up and use 1Password CLI (op). Use when installing the CLI, enabling desktop app integration, signing in (single or multi-account), or reading/injecting/running secrets via op.
CLI to manage emails via IMAP/SMTP. Use `himalaya` to list, read, write, reply, forward, search, and organize emails from the terminal. Supports multiple accounts and message composition with MML (MIME Meta Language).
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Set up and use 1Password CLI (op). Use when installing the CLI, enabling desktop app integration, signing in (single or multi-account), or reading/injecting/running secrets via op.
CLI to manage emails via IMAP/SMTP. Use `himalaya` to list, read, write, reply, forward, search, and organize emails from the terminal. Supports multiple accounts and message composition with MML (MIME Meta Language).
