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

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 # 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 details

• Whale Alert - Real-time whale transaction API

• Etherscan - Ethereum blockchain explorer

• CoinGecko - Price data API