whale-tracking
Large wallet monitoring, accumulation and distribution detection, and smart money signal generation for Solana tokens
By agiprolabs · 391 installs
npx skills add agiprolabs/claude-trading-skills --skill whale-tracking
Source repository · Upstream listing
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
Category Trade Size Portfolio Size Typical Behavior
Retail < 10 SOL < 100 SOL Reactive, follows trends
Mid size 10 100 SOL 100 1,000 SOL Mixed strategies
Whale 100 1,000 SOL 1,000 10,000 SOL Informed, moves markets
Mega whale 1,000 SOL 10,000 SOL Market makers, funds, insiders
Relative Thresholds (Per Token)
Metric Threshold Significance
% of supply held 2% Significant holder
% of daily volume 5% single trade Market moving transaction
Top N holders Top 20 Core holder group
Concentration ratio Top 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 :
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 :
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:
Wallet Classification Tags
Tag Description
sniper Buys tokens within minutes of launch
dex trader Primarily trades on DEXes
accumulator Builds positions gradually
flipper Short hold times, quick profit taking
insider Connected to token teams (funded by deployer)
fund Institutional or fund wallet
market maker Provides 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 Count Signal Confidence
1 whale buying Informational Low
2 3 whales buying Notable Medium
4+ whales buying Strong convergence High
Whales + volume spike Confirmed momentum Very high
Cross Token Flow Analysis
Track where whale capital flows:
Data Sources
Whale tracking on Solana uses multiple data sources. See references/data sources.md for complete details.
Source Use Case Auth Required
Helius Transaction history, webhooks Yes (free tier available)
SolanaTracker Top traders, wallet PnL Yes
Birdeye Token holder rankings Yes (free tier available)
Solana RPC Token accounts, signatures No (public endpoints)
Helius Webhooks for Real Time Tracking
Helius webhooks enable real time whale alerts without polling:
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
Integration with Other Skills
Whale tracking works best when combined with other analysis:
Skill Integration
token holder analysis Identify concentration risk, insider wallets
liquidity analysis Estimate price impact of whale trades
solana onchain Wallet profiling, transaction history
slippage modeling Predict slippage for whale sized trades
risk management Factor whale concentration into position sizing
helius api Transaction 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