Skip to main content
skill CX Codex

monitoring-whale-activity — Claude Code skill

The monitoring-whale-activity skill monitors large cryptocurrency transactions and whale wallet movements across multiple blockchains in real-time. Triggers on phrases like "track whales", "monitor large transfers", "check whale activity".

MIT 1 installs ★ 2,935 updated 2026-11-01

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add jeremylongshore/tons-of-skills-marketplace --skill monitoring-whale-activity -a claude-code
Open on GitHub

What monitoring-whale-activity does

The skill tracks wallet-to-wallet transfers (TRANSFER), deposits to exchanges (DEPOSIT) and withdrawals (WITHDRAWAL), revealing whether whales are selling or accumulating. Built-in labels identify known exchange addresses, funds, and bridges.

It requires Python 3.8+ with the requests library and optionally uses the Whale Alert API (free tier available). Commands run from the scripts directory: python whale_monitor.py recent shows large transactions, python whale_monitor.py flows analyzes exchange inflows and outflows, python whale_monitor.py watchlist manages custom wallet tracking. Filter by blockchain (Ethereum, Polygon, etc.) and minimum transaction value using --chain and --min-value flags.

Output displays as a table or JSON via --format json. If the API is unavailable, the skill falls back to CoinGecko for pricing and continues operation.

What it helps with

  • detect when whales move funds to an exchange (selling pressure signal)
  • identify whether large holders are accumulating or distributing
  • look up known addresses like Binance, Kraken, funds, and bridges
  • monitor a custom list of critical wallets
  • compare exchange inflows and outflows by blockchain

Example prompts for the agent

  • show whale transactions on Ethereum above $10 million
  • check if whales are sending funds to exchanges
  • add an address to the watchlist and name it "Binance Cold Wallet"

How to install monitoring-whale-activity

1Skills CLI (Vercel)

npx skills add jeremylongshore/tons-of-skills-marketplace --skill monitoring-whale-activity -a claude-code

2Manually: put the files in place

~/.claude/skills/monitoring-whale-activity/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/monitoring-whale-activity/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about monitoring-whale-activity

How do I install monitoring-whale-activity in Claude Code?

Run npx skills add jeremylongshore/tons-of-skills-marketplace --skill monitoring-whale-activity -a claude-code in the terminal, then open ~/.claude/skills/monitoring-whale-activity/SKILL.md.

What does this skill do?

It tracks large cryptocurrency transactions and wallet movements between addresses, exchanges, and other services in real-time. It helps you spot when whales (large holders) are selling, accumulating, or withdrawing from exchanges.

What do I need to run it?

Python 3.8+ and the requests library. A Whale Alert API key is optional (free tier available) for live data; the skill can also use CoinGecko pricing as a fallback.

Source text

SKILL.md · MIT
---
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.27.0
author: Jeremy Longshore <[email protected]>
license: MIT
tags:
- crypto
- monitoring
- monitoring-whale
compatibility: Designed for Claude Code
---
# Monitoring Whale Activity

## Contents

[Overview](#overview) | [Prerequisites](#prerequisites) | [Instructions](#instructions) | [Output](#output) | [Error Handling](#error-handling) | [Examples](#examples) | [Resources](#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

```bash
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:

```bash
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 [`references/errors.md`](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:**

```bash
python whale_monitor.py recent --chain ethereum --min-value 10000000  # 10000000 = 10M limit
```

**Example 2: Analyze if whales are selling:**

```bash
python whale_monitor.py flows --chain ethereum
```

**Example 3: Track a known whale wallet:**

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

**Example 4: Export to JSON for further analysis:**

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

See [`references/examples.md`](references/examples.md) for more usage patterns.

## Resources

- [`references/implementation.md`](references/implementation.md) - Flow analysis, wallet database, multi-chain details
- [Whale Alert](https://whale-alert.io) - Real-time whale transaction API
- [Etherscan](https://etherscan.io) - Ethereum blockchain explorer
- [CoinGecko](https://coingecko.com) - Price data API

© Jeremy Longshore · MIT · jeremylongshore/tons-of-skills-marketplace

Similar skills

All skills for AI and ML →

From the same set139

The whole set →
sentry-policy-guardrails The sentry-policy-guardrails skill outlines shared Sentry rules across services, including event scrubbing, trace-rate caps, and CI checks for configuration drift. CX Codex +1 1installs gc-log-analyzer A skill for reading garbage collector logs in performance testing work. It turns on by itself when the request mentions gc log analyzer. CX Codex +1 1installs klingai-audit-logging klingai-audit-logging sets up tamper-evident audit logging for Kling AI API calls. It tracks video generation tasks, checks log integrity, and hashes prompts. CX Codex +1 1installs openrouter-audit-logging The openrouter-audit-logging skill adds an audit trail for OpenRouter calls, recording request metadata, cost, and a prompt hash. Use it to investigate errors or track model usage. CX Codex +1 1installs lokalise-observability lokalise-observability sets up metrics, webhook tracking, and rate limit checks for Lokalise pipelines. Useful for tracking translation progress and API health. CX Codex +1 1installs model-evaluation-metrics The model-evaluation-metrics skill supports model evaluation work in ML Training by generating code, configurations, guidance, and checks for the results. CX Codex +1 1installs date-range-analyzer A skill for date range work in data analytics tasks. It turns on by itself when a request mentions date range analyzer. CX Codex +1 1installs data-story-outliner data-story-outliner — a skill for Claude Code, Codex, Cursor, and other AI coding assistants that auto-activates when working with data analytics. CX Codex +1 1installs

Project sponsors

Companies that keep this analytics open