MCPInstall

whale-tracking

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

Installs
495
Last 24h
—
Trending rank
—
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/agiprolabs/claude-trading-skills --skill whale-tracking
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads whale-tracking automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

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
  • Confidence increases with: whale track record, buy size, number of whales buying
  • Weaken signal if: token is very new (< 24h), whale is known flipper, high concentration risk

Whale Sell Signal:

  • Whale sells > 25% of position or > 100 SOL
  • Confidence increases with: multiple whales selling, transfers to exchanges, increasing sell frequency
  • Weaken signal if: whale is taking partial profit after large gain, whale is known rebalancer

Accumulation Signal:

  • Whale accumulation score >= 4 (see scoring above)
  • Strongest when: multiple whales accumulating same token, accumulation during price downtrend
  • Time horizon: days to weeks (accumulation is a slow signal)

Distribution Signal:

  • Whale distribution score >= 4
  • Strongest when: team/insider wallets distributing, post-unlock distribution, increasing sell pace
  • Time horizon: hours to days (distribution can accelerate quickly)

Signal Scoring

def compute_whale_signal(whale_activity: dict) -> dict:
    """Combine whale activity indicators into a composite signal."""
    score = 0.0

    # Trade direction: +1 for buy, -1 for sell
    direction = 1 if whale_activity["is_buy"] else -1

    # Size factor: larger trades = stronger signal
    size_sol = whale_activity["size_sol"]
    if size_sol > 500:
        score += direction * 3
    elif size_sol > 100:
        score += direction * 2
    else:
        score += direction * 1

    # Whale quality: better track record = stronger signal
    win_rate = whale_activity["whale_win_rate"]
    score *= (0.5 + win_rate)  # 0.5x to 1.5x multiplier

    # Convergence: multiple whales = stronger signal
    whale_count = whale_activity["concurrent_whale_count"]
    score *= (1 + 0.3 * (whale_count - 1))

    return {
        "score": round(score, 2),
        "direction": "bullish" if score > 0 else "bearish",
        "confidence": "high" if abs(score) > 5 else "medium" if abs(score) > 2 else "low",
    }

Integration with Other Skills

Whale tracking works best when combined with other analysis:

SkillIntegration
token-holder-analysisIdentify concentration risk, insider wallets
liquidity-analysisEstimate price impact of whale trades
solana-onchainWallet profiling, transaction history
slippage-modelingPredict slippage for whale-sized trades
risk-managementFactor whale concentration into position sizing
helius-apiTransaction fetching, webhook setup

Files

References

  • references/detection_methods.md — Accumulation/distribution detection algorithms, whale classification, alert thresholds and scoring systems
  • references/data_sources.md — Complete guide to Helius, SolanaTracker, Birdeye, and on-chain data sources for whale tracking

Scripts

  • scripts/track_whales.py — Fetches top holders for a token, classifies whale activity as accumulating/distributing/holding, prints a whale report. Run with --demo for synthetic data mode.
  • scripts/whale_alerts.py — Monitors a watchlist of whale wallets for new large transactions, classifies trades, and prints alerts. Run with --demo for simulated whale trades.

Limitations and Caveats

  • Privacy wallets: Whales using multiple wallets or mixers can evade tracking
  • Misleading signals: Whales may intentionally create visible accumulation to attract followers, then dump
  • Latency: By the time you detect a whale buy, the price impact may already be priced in
  • False positives: Internal transfers between a whale's own wallets look like buys/sells
  • Exchange wallets: Centralized exchange hot wallets show massive flows that are not individual whale activity
  • Not financial advice: Whale activity is informational input for analysis, not a standalone trading recommendation

FAQ

What does the whale-tracking skill do?

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

How do I install whale-tracking?

Run npx skills add https://github.com/agiprolabs/claude-trading-skills --skill whale-tracking in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/whale-tracking/ (personal) or .claude/skills/whale-tracking/ (project).

Which AI agents can use whale-tracking?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is whale-tracking safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains whale-tracking?

It is published by agiprolabs in agiprolabs/claude-trading-skills. It has 495 recorded installs.

More from agiprolabs/claude-trading-skills

View all →

walk-forward-validation

agiprolabs/claude-trading-skills

Walk-forward validation framework for trading strategies and ML models with time-series-aware splits, overfit detection, and regime-aware validation

Business & Finance714 installs

risk-management

agiprolabs/claude-trading-skills

Portfolio-level risk controls, drawdown management, exposure limits, and circuit breakers for crypto trading

Business & Finance637 installs

pandas-ta

agiprolabs/claude-trading-skills

Technical analysis with 130+ indicators using pandas-ta for crypto market data

Data & Databases593 installs

position-sizing

agiprolabs/claude-trading-skills

Trade sizing methods including fixed fractional, volatility-adjusted, Kelly criterion, and liquidity-constrained sizing

Business & Finance581 installs

regime-detection

agiprolabs/claude-trading-skills

Market regime identification using volatility clustering, trend detection, and statistical methods for adaptive trading

Business & Finance578 installs

kelly-criterion

agiprolabs/claude-trading-skills

Kelly criterion optimal sizing with fractional variants, edge estimation, and practical application for crypto trading

Business & Finance534 installs

Popular devops & cloud skills

View category →

microsoft-foundry

microsoft/azure-skills

Build, deploy, evaluate, optimize, fine-tune, and manage Microsoft Foundry agents, models, and resources end to end. USE FOR: foundry, azd ai agent, azd provision/deploy, hosted agent scaffold/develop/run/deploy/troubleshoot, prompt agent create, managed harness agent create, GitHub Copilot harness agent, create agent, update agent, add tool to agent, invoke agent, agent insights, evaluate agent, batch eval, continuous eval, continuous monitoring, agent CI/CD, optimize prompt, improve prompt, optimize agent instructions, Agent Optimizer scaffold, dataset curation from traces, deploy model, model fine-tuning (SFT/DPO/RFT), Foundry project, RBAC, role assignment, permissions, quota, capacity, region, deployment failure, AI Services, create Foundry resource, knowledge index, customize deployment, onboard, availability, training-data, grader, distillation, large file upload. DO NOT USE FOR: Azure Functions, App Service, general Azure deploy (use azure-deploy), general Azure prep (use azure

OfficialDevOps & Cloud579.1K installs

azure-diagnostics

microsoft/azure-skills

Debug Azure production issues on Azure using AppLens, Azure Monitor, resource health, and safe triage. WHEN: debug production issues, troubleshoot app service, app service high CPU, app service deployment failure, troubleshoot container apps, container app 503 or target port mismatch, troubleshoot functions, function telemetry missing or stopped after a config/connection-string change, troubleshoot AKS, VM RDP, Linux SSH, VM black screen, can't connect to VM, reset VM password, NSG or firewall blocking, kubectl cannot connect, kube-system/CoreDNS failures, pod pending, crashloop, node not ready, upgrade failures, analyze logs, KQL, insights, image pull failures, cold start issues, health probe failures, resource health, root cause of errors, troubleshoot event hubs, troubleshoot service bus, messaging SDK error, AMQP connection failure, message lock lost, lock renewal during long-running processing, service bus dead letter.

OfficialDevOps & Cloud569.8K installs

azure-prepare

microsoft/azure-skills

Prepare azd-based Azure projects for deployment: generates azure.yaml, infrastructure (Bicep/Terraform), and Dockerfiles for the Azure Developer CLI (azd) workflow. USE ONLY when the user explicitly wants to use azd as the deployment tool, or the project already has an azure.yaml file. DO NOT USE FOR: non-azd deployments, Python App Service code-only deploys (use python-appservice-deploy), or cross-cloud migration (use azure-cloud-migrate). WHEN: prepare app for azd, create azure.yaml, set up azd infrastructure, modernize app for Azure with azd, deploy with azd, function app, timer trigger, service bus trigger, event-driven function, managed identity, generate Bicep, generate Terraform, create and deploy to Azure.

OfficialDevOps & Cloud569K installs

azure-ai

microsoft/azure-skills

Use for Azure AI: Search, Speech, OpenAI, Document Intelligence. Helps with search, vector/hybrid search, speech-to-text, text-to-speech, transcription, OCR. WHEN: AI Search, query search, vector search, hybrid search, semantic search, speech-to-text, text-to-speech, transcribe, OCR, convert text to speech.

OfficialDevOps & Cloud568.8K installs

azure-deploy

microsoft/azure-skills

Execute Azure deployments for ALREADY-PREPARED applications that have existing .azure/deployment-plan.md and infrastructure files. DO NOT use this skill when the user asks to CREATE a new application — use azure-prepare instead. This skill runs azd up, azd deploy, terraform apply, and az deployment commands with built-in error recovery. Requires .azure/deployment-plan.md from azure-prepare and validated status from azure-validate. WHEN: "run azd up", "run azd deploy", "execute deployment", "push to production", "push to cloud", "go live", "ship it", "bicep deploy", "terraform apply", "publish to Azure", "launch on Azure". DO NOT USE WHEN: "create and deploy", "build and deploy", "create a new app", "set up infrastructure", "create and deploy to Azure using Terraform" — use azure-prepare for these.

OfficialDevOps & Cloud568.6K installs

azure-validate

microsoft/azure-skills

Pre-deployment validation for Azure readiness. Run deep checks on configuration, infrastructure (Bicep or Terraform), RBAC role assignments, managed identity permissions, and prerequisites before deploying. WHEN: validate my app, check deployment readiness, run preflight checks, verify configuration, check if ready to deploy, validate azure.yaml, validate Bicep, test before deploying, troubleshoot deployment errors, validate Azure Functions, validate function app, validate serverless deployment, verify RBAC roles, check role assignments, review managed identity permissions, what-if analysis, validate Container Apps deployment.

OfficialDevOps & Cloud568K installs