# Crypto Whale Alerts

> Real-time cryptocurrency whale tracker for AI agents and crypto traders. Monitors large on-chain transactions on Bitcoin, Ethereum, and major altcoins, tracks known whale wallets (exchanges, institutions, smart money), detects accumulation/distribution patterns, and generates actionable alerts. Commands: - whale_alerts.py scan Scan for whale transactions above threshold - whale_alerts.py summary Get whale activity summary - whale_alerts.py watch List tracked whale wallet addresses - whale_alerts.py set-threshold <usd> Set minimum USD threshold Environment: WHALE_MIN_USD (default 100000), WHALE_COOLDOWN (default 60 min). Python 3.9+, zero external dependencies. Uses mock data structure that maps to real Etherscan/Blockchair API responses in production. Whale classification: INFLOW (exchange receiving, potential selling pressure) vs OUTFLOW (cold storage, accumulation signal). Watchlist includes Binance, Coinbase, Grayscale, and notable smart money addresses.

- Skill: `lord1egypt/crypto-whale-alerts` (Agent Skill)
- Install (CLI): `npx skillmds@latest add lord1egypt/crypto-whale-alerts`
- Raw SKILL.md: https://api.skillmd.com/api/skills/lord1egypt/crypto-whale-alerts/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: Lord1Egypt (https://skillmd.com/u/lord1egypt)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/lord1egypt/crypto-whale-alerts

---


# Crypto Whale Alerts

Tracks large on-chain transactions and whale wallet movements to generate actionable crypto trading alerts.

## Configuration

```bash
# Set minimum transaction threshold in USD
export WHALE_MIN_USD=500000

# Set alert cooldown period in minutes
export WHALE_COOLDOWN=30
```

## Commands

```bash
# Scan for whale transactions above threshold
python scripts/whale_alerts.py scan

# Get whale activity summary
python scripts/whale_alerts.py summary

# View tracked whale wallet addresses
python scripts/whale_alerts.py watch

# Change minimum threshold
python scripts/whale_alerts.py set-threshold 250000
```

## Alert Interpretation

- **INFLOW** (green): Large transaction into exchange hot wallet
  - Could indicate imminent selling pressure
  - Watch for distribution patterns

- **OUTFLOW** (red): Large transaction from exchange to cold storage
  - Could indicate accumulation phase
  - Often precedes price increases

## Watchlist

Includes major exchange hot wallets, institutional custodians, and notable smart money addresses:
- Binance Hot (multiple wallets)
- Coinbase Custody
- Grayscale Trust wallets
- DeFi protocol treasuries

## Production Integration

For live data, connect to:
- Etherscan API for Ethereum transactions
- Blockchair API for multi-chain coverage
- Glassnode for whale wallet labels

The script uses mock data with real field structure for easy API integration.