monitoring-whale-activity

name	monitoring-whale-activity
description	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".
allowed-tools	Read, Write, Edit, Grep, Glob, Bash(python:*whale*)
version	1.0.0
author	Jeremy Longshore <[e-mail]>
license	MIT
compatible-with	claude-code, codex, openclaw
tags	["crypto","monitoring","monitoring-whale"]

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

1. Install Python 3.8+ with requests library
2. Optionally obtain Whale Alert API key (free tier available for live data)
3. Verify internet access for API calls

Instructions

Step 1: Navigate to Scripts Directory

cd ${CLAUDE_SKILL_DIR}/scripts

Step 2: Choose a Command

1. View recent whale transactions: python whale_monitor.py recent
2. Analyze exchange flows: python whale_monitor.py flows
3. Manage watchlist: python whale_monitor.py watchlist
4. Track specific wallet: python whale_monitor.py track 0x123...
5. 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