whale-tracking Checked

**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

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

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.

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

# 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