Monitoring Whale Activity

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".

Dicklesworthstone/pi_agent_rust·0installs1.8Kstars

SKILL.md

Full skill instructions

Monitoring Whale Activity

Overview

Track large cryptocurrency transactions and whale wallet movements across multiple blockchains. Monitor exchange inflows/outflows, manage watchlists, and identify known wallets (exchanges, funds, bridges).

Prerequisites

Before using this skill, ensure you have:

Python 3.8+ with requests library
Whale Alert API key (optional, for live data - free tier available)
Internet access for API calls

Instructions

Step 1: Navigate to Scripts Directory

cd {baseDir}/scripts

Step 2: Choose Your Command

Recent Whale Transactions:

python whale_monitor.py recent                    # All chains
python whale_monitor.py recent --chain ethereum   # Specific chain
python whale_monitor.py recent --min-value 10000000  # $10M+ only

Exchange Flow Analysis:

python whale_monitor.py flows                     # Overall exchange flows
python whale_monitor.py flows --chain ethereum    # Chain-specific

Watchlist Management:

python whale_monitor.py watchlist                 # View watchlist
python whale_monitor.py watch 0x123... --name "My Whale"  # Add to watchlist
python whale_monitor.py unwatch 0x123...          # Remove from watchlist

Track Specific Wallet:

python whale_monitor.py track 0x123...            # Track wallet activity

Search Known Labels:

python whale_monitor.py labels --query binance    # Search by name
python whale_monitor.py labels --type exchange    # List by type

Step 3: Interpret Results

Transaction Types:

🔴 DEPOSIT → 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

Error Handling

See {baseDir}/references/errors.md for:

API rate limit handling
Network timeout recovery
Invalid address formats
Price service fallbacks

Examples

View $10M+ whale transactions on Ethereum:

python whale_monitor.py recent --chain ethereum --min-value 10000000

Analyze if whales are selling (depositing to exchanges):

python whale_monitor.py flows --chain ethereum

Track a known whale wallet:

python whale_monitor.py watch 0x28c6c... --name "Binance Cold"
python whale_monitor.py track 0x28c6c...

Export to JSON for further analysis:

python whale_monitor.py recent --format json > whales.json

See {baseDir}/references/examples.md for more usage patterns.

Resources

Whale Alert - Real-time whale transaction API
Etherscan - Ethereum blockchain explorer
CoinGecko - Price data API
Known wallet database with 100+ labeled exchanges and protocols

Install skill

Copy and run in your terminal

npx -y skills add https://github.com/Dicklesworthstone/pi_agent_rust --skill monitoring-whale-activity

View on GitHub

tests/ext_conformance/artifacts/plugins-community/plugins/crypto/whale-alert-monitor/skills/monitoring-whale-activity/SKILL.md

deepgram-hello-world
Create a minimal working Deepgram transcription example. Use when starting a new Deepgram integration, testing your setup, or learning basic Deepgram API patterns. Trigger with phrases like "deepgram hello world", "deepgram example", "deepgram quick start", "simple transcription", "transcribe aud...
0 installs
interactive-shell
Cheat sheet + workflow for launching interactive coding-agent CLIs (Claude Code, Gemini CLI, Codex CLI, Cursor CLI, and pi itself) via the interactive_shell overlay or headless dispatch. Use for TUI agents and long-running processes that need supervision, fire-and-forget delegation, or headless b...
0 installs
documenso-prod-checklist
Execute Documenso production deployment checklist and rollback procedures. Use when deploying Documenso integrations to production, preparing for launch, or implementing go-live procedures. Trigger with phrases like "documenso production", "deploy documenso", "documenso go-live", "documenso launc...
0 installs
interactive-portfolio
Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios, and portfolios that convert visitors into opportunities. Use when: portfolio, personal website, sho...
0 installs