agiprolabs/claude-trading-skills5 files

Whale Tracking

Large wallet monitoring, accumulation and distribution detection, and smart money signal generation for Solana tokens

Specification
Skill ID
agiprolabs/claude-trading-skills/whale-tracking
Publisher
agiprolabs
Repository
claude-trading-skills
Installs
0
Files
5
Synced
Sep 23, 2026
How to use it

Open any RiverX project, open the Skills panel in the chat, and search for this identifier. The files are fetched from the source repository at install time.

agiprolabs/claude-trading-skills/whale-trackingInstalls these files
  • SKILL.md
  • references/data_sources.md
  • references/detection_methods.md
  • scripts/track_whales.py
  • scripts/whale_alerts.py

What this skill tells the agent

Whale Tracking for Solana Tokens

Whale tracking monitors the on-chain behavior of large wallets to detect accumulation, distribution, and smart money movements before they become visible in price action. On Solana, where token ownership is highly concentrated and whale transactions can move markets instantly, tracking large holders is one of the highest-signal alpha sources available.

Why Whale Tracking Matters

A single large wallet selling 5% of a token's supply can crash the price 30-50% on thin Solana DEX liquidity. Conversely, a known profitable wallet accumulating a new token often precedes major price runs. Whale tracking converts on-chain transparency into actionable intelligence.

Key use cases:

  • Early warning: Detect large holder sells before the price impact fully propagates
  • Smart money following: Identify wallets with strong track records and monitor their new positions
  • Accumulation detection: Spot gradual buying by whales who split orders to avoid detection
  • Distribution detection: Catch insiders or early investors offloading positions
  • Risk assessment: Evaluate token concentration risk before entering a position

What Constitutes a Whale

Whale classification depends on context. A wallet holding $50K of a $1M market cap token is a whale; the same $50K in SOL is not. Use relative and absolute thresholds:

Absolute Thresholds

CategoryTrade SizePortfolio SizeTypical Behavior
Retail< 10 SOL< 100 SOLReactive, follows trends
Mid-size10-100 SOL100-1,000 SOLMixed strategies
Whale100-1,000 SOL1,000-10,000 SOLInformed, moves markets
Mega-whale> 1,000 SOL> 10,000 SOLMarket makers, funds, insiders

Relative Thresholds (Per Token)

MetricThresholdSignificance
% of supply held> 2%Significant holder
% of daily volume> 5% single tradeMarket-moving transaction
Top N holdersTop 20Core holder group
Concentration ratioTop 10 hold > 50%High concentration risk

Use both absolute and relative metrics. A 50 SOL trade in a $200K market cap token is whale-level; the same trade in a $50M token is retail.

Accumulation vs Distribution Patterns

Accumulation Signals

Accumulation is when a whale builds a position over time, often trying to minimize price impact.

DCA pattern (Dollar-Cost Averaging):

  • Multiple buys of similar size over hours or days
  • Buys at regular intervals (e.g., every 30 minutes)
  • Position grows steadily without large single transactions

Dip buying:

  • Buys concentrated during price dips
  • Larger-than-usual purchases when price drops > 10%
  • Position increases during periods of general selling

Multi-wallet accumulation:

  • New wallets funded from the same source
  • Each wallet buys small amounts of the same token
  • Positions later consolidated into a primary wallet

Detection heuristics:

accumulation_score = 0
if buy_count > sell_count * 2:       accumulation_score += 2
if avg_buy_size > avg_sell_size:     accumulation_score += 1
if position_change_7d > 0:          accumulation_score += 1
if buys_during_dips > buys_on_pump:  accumulation_score += 2
if dca_pattern_detected:             accumulation_score += 2
# Score >= 4 = likely accumulating

Distribution Signals

Distribution is when a whale reduces or exits a position, often gradually to avoid crashing the price.

Gradual selling:

  • Multiple sells over days, each < 5% of position
  • Sells increase in frequency over time
  • Position shrinks steadily

Transfer to exchange:

  • Tokens transferred to known exchange deposit addresses
  • Large transfers to Binance, OKX, Bybit hot wallets
  • Often precedes selling by hours or days

Rapid exit:

  • Single large market sell (> 20% of position)
  • Often triggers cascading liquidations
  • Visible as large red candles with high volume

Detection heuristics:

distribution_score = 0
if sell_count > buy_count * 2:        distribution_score += 2
if position_change_7d < 0:           distribution_score += 1
if transfers_to_exchanges > 0:       distribution_score += 3
if sell_frequency_increasing:        distribution_score += 2
if position_pct_remaining < 50:      distribution_score += 1
# Score >= 4 = likely distributing

Whale Watchlist Management

Maintain a watchlist of wallets worth tracking. Sources for discovering whale wallets:

Discovery Methods

  1. Top holders per token: Query getTokenLargestAccounts for any token of interest
  2. Large transaction monitoring: Watch for trades > 100 SOL on key tokens
  3. Profitable trader rankings: Use SolanaTracker or Birdeye top trader endpoints
  4. Known fund wallets: Public wallet addresses of crypto funds and DAOs
  5. Cross-referencing: Wallets that appear in top holders of multiple successful tokens

Watchlist Structure

Each watchlist entry should track:

whale_entry = {
    "address": "WhaLe...",
    "label": "Smart money #47",        # Human-readable label
    "discovered": "2026-01-15",         # When added to watchlist
    "discovery_reason": "top_trader",   # How they were found
    "win_rate": 0.72,                   # Historical trade win rate
    "avg_pnl": 3.4,                     # Average PnL multiplier
    "tokens_tracked": 12,               # Number of tokens held
    "last_active": "2026-03-09",        # Last on-chain activity
    "tags": ["dex_trader", "sniper"],   # Classification tags
}

Wallet Classification Tags

TagDescription
sniperBuys tokens within minutes of launch
dex_traderPrimarily trades on DEXes
accumulatorBuilds positions gradually
flipperShort hold times, quick profit-taking
insiderConnected to token teams (funded by deployer)
fundInstitutional or fund wallet
market_makerProvides liquidity, two-sided flow

Cross-Token Analysis

Whale tracking becomes most powerful when you analyze whale behavior across multiple tokens simultaneously.

Convergence Signals

When multiple tracked whales buy the same token independently, the signal strength compounds:

Whale CountSignalConfidence
1 whale buyingInformationalLow
2-3 whales buyingNotableMedium
4+ whales buyingStrong convergenceHigh
Whales + volume spikeConfirmed momentumVery high

Cross-Token Flow Analysis

Track where whale capital flows:

Token A (selling) → SOL → Token B (buying)

If multiple whales rotate from A to B:
  - Bearish for Token A (smart money exiting)
  - Bullish for Token B (smart money entering)

Data Sources

Whale tracking on Solana uses multiple data sources. See references/data_sources.md for complete details.

SourceUse CaseAuth Required
HeliusTransaction history, webhooksYes (free tier available)
SolanaTrackerTop traders, wallet PnLYes
BirdeyeToken holder rankingsYes (free tier available)
Solana RPCToken accounts, signaturesNo (public endpoints)

Helius Webhooks for Real-Time Tracking

Helius webhooks enable real-time whale alerts without polling:

# Webhook configuration for whale wallet monitoring
webhook_config = {
    "webhookURL": "https://your-server.com/whale-alerts",
    "transactionTypes": ["SWAP", "TRANSFER"],
    "accountAddresses": [
        "WhaLe1...",  # Tracked whale wallets
        "WhaLe2...",
    ],
    "webhookType": "enhanced",  # Parsed transaction data
}

Signal Generation

Convert whale activity into trading signals. Whale signals are one input to a broader decision framework, not standalone trading triggers.

Signal Types

Whale Buy Signal:

  • Whale buys > 100 SOL of a token

Use this skill in a project

Open any RiverX project, search the Skills panel for agiprolabs/claude-trading-skills/whale-tracking, and install it in one click.

Use this skill