mcpField
M
monitoring-whale-activity

monitoring-whale-activity

github.com/jeremylongshoreOther2.9k55 installsUpdated 2d ago
Repository

About monitoring-whale-activity

A command-line skill for tracking large cryptocurrency transactions and whale wallet activity across multiple blockchains. It supports transaction and exchange-flow analysis, labeled wallet searches, and custom watchlists.

Key features

  1. 01View recent whale transactions
  2. 02Analyze exchange inflows and outflows
  3. 03Manage wallet watchlists
  4. 04Track specific wallets
  5. 05Search labeled wallets
  6. 06Export results as JSON, tables, or alerts

Use cases

  1. 01Filter large transactions by chain and value
  2. 02Assess whale-related exchange flows
  3. 03Monitor a known wallet
  4. 04Export transaction data for analysis

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/jeremylongshore/tons-of-skills-marketplace --skill monitoring-whale-activity

After installing, type/monitoring-whale-activityin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

ARD.md
PRD.md
config/
settings.yaml
references/
errors.md
examples.md
implementation.md
scripts/
formatters.py
price_service.py
wallet_labels.py
whale_api.py
whale_monitor.py

Details

From the project README

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

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

Comments

Markdown supported