whale-tracking

Solana トークンのクジラ追跡

クジラ追跡では、大口ウォレットのオンチェーンでの動きを監視し、価格変動に表れる前に、蓄積、分配、スマートマネーの動きを検出します。トークンの所有が高度に集中し、クジラの取引が瞬時に市場を動かすことがある Solana では、大口保有者の追跡は、利用できる最も有力なアルファ情報源の 1 つです。

クジラ追跡が重要な理由

1 つの大口ウォレットがトークン供給量の 5% を売却すると、Solana DEX の流動性が薄い場合、価格が 30〜50% 暴落することがあります。反対に、利益を上げてきたことで知られるウォレットが新しいトークンを買い集めている場合、その後に大幅な価格上昇が続くことがよくあります。クジラ追跡により、オンチェーンの透明性を実用的な情報に変換できます。

主なユースケース：

• 早期警告：価格への影響が完全に波及する前に、大口保有者の売却を検出します
• スマートマネーの追跡：実績のあるウォレットを特定し、新たなポジションを監視します
• 蓄積の検出：検出を避けるため注文を分割するクジラの段階的な買いを見つけます
• 分配の検出：インサイダーや初期投資家によるポジションの売却を捉えます
• リスク評価：ポジションを取る前に、トークンの保有集中リスクを評価します

クジラの定義

クジラの分類は状況によって異なります。時価総額 100 万ドルのトークンを 5 万ドル分保有するウォレットはクジラですが、SOL を同額保有していてもクジラではありません。相対的な基準と絶対的な基準の両方を使いましょう。

絶対的な基準

カテゴリ	取引サイズ	ポートフォリオサイズ	典型的な行動
個人投資家	< 10 SOL	< 100 SOL	反応的で、トレンドを追います
中規模	10-100 SOL	100-1,000 SOL	複数の戦略を使います
クジラ	100-1,000 SOL	1,000-10,000 SOL	情報に基づいて行動し、市場を動かします
メガクジラ	> 1,000 SOL	> 10,000 SOL	マーケットメーカー、ファンド、インサイダー

相対的な基準（トークンごと）

指標	基準	意義
保有供給量の割合	> 2%	重要な保有者
1 日の取引高に占める割合	1 回の取引で > 5%	市場を動かす取引
上位 N 保有者	上位 20	中核となる保有者グループ
集中度	上位 10 が > 50% を保有	保有集中リスクが高い

絶対的な指標と相対的な指標の両方を使いましょう。時価総額 20 万ドルのトークンでの 50 SOL の取引はクジラ級ですが、時価総額 5,000 万ドルのトークンでは個人投資家レベルです。

蓄積と分配のパターン

蓄積のシグナル

蓄積とは、価格への影響を最小限に抑えようとしながら、クジラが時間をかけてポジションを構築することです。

DCA パターン（ドルコスト平均法）：

• 数時間から数日にわたり、同程度の規模の買いを複数回行います
• 一定間隔（例：30 分ごと）で買います
• 大規模な単発取引を行わず、ポジションを着実に増やします

押し目買い：

• 価格下落時に買いが集中します
• 価格が 10% を超えて下落した際に、通常より大きな買いを行います
• 全般的に売りが続く期間にもポジションを増やします

複数ウォレットによる蓄積：

• 同じ送金元から資金提供を受けた新しいウォレットが作られます
• 各ウォレットが同じトークンを少額ずつ買います
• 後にポジションがメインウォレットへ統合されます

検出のヒューリスティクス：

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

分配のシグナル

分配とは、価格の暴落を避けるために段階的に行うことが多い、クジラによるポジションの縮小または解消です。

段階的な売却：

• 数日にわたって複数回売却し、1 回あたりの売却量はポジションの 5% 未満です
• 時間の経過とともに売却頻度が増加します
• ポジションが着実に縮小します

取引所への送金：

• トークンが既知の取引所入金アドレスに送金されます
• Binance、OKX、Bybit のホットウォレットへ大口送金します
• 多くの場合、その数時間後または数日後に売却が行われます

急速な撤退：

• 大規模な成行売り 1 回（ポジションの > 20%）
• 連鎖的な清算を引き起こすことがよくあります
• 出来高を伴う大きな赤いローソク足として確認できます

検出のヒューリスティクス：

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

クジラのウォッチリスト管理

追跡する価値のあるウォレットのウォッチリストを管理します。クジラのウォレットを見つけるための情報源：

検出方法

1. トークンごとの大口保有者：関心のあるトークンについて getTokenLargestAccounts を照会します
2. 大口取引のモニタリング：主要なトークンで 100 SOL を超える取引を監視します
3. 収益性の高いトレーダーのランキング：SolanaTracker または Birdeye のトップトレーダーエンドポイントを使用します
4. 既知のファンドウォレット：暗号資産ファンドや DAO の公開ウォレットアドレスを使用します
5. 相互参照：複数の成功したトークンの上位保有者に現れるウォレットを特定します

ウォッチリストの構成

各ウォッチリストの項目には、次の情報を記録します。

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
}

ウォレット分類タグ

タグ	説明
sniper	ローンチから数分以内にトークンを購入します
dex_trader	主に DEX で取引します
accumulator	徐々にポジションを構築します
flipper	保有期間が短く、素早く利益を確定します
insider	トークンチームとつながりがあります（デプロイヤーから資金提供を受けています）
fund	機関投資家またはファンドのウォレットです
market_maker	流動性を提供し、双方向のフローを生み出します

トークン横断分析

クジラの追跡は、複数のトークンにまたがるクジラの行動を同時に分析すると、最も効果を発揮します。

集中シグナル

追跡対象の複数のクジラが、それぞれ独立して同じトークンを購入すると、シグナルの強度が高まります。

クジラ数	シグナル	信頼度
1 頭のクジラが購入	参考情報	低
2～3 頭のクジラが購入	注目に値する	中
4 頭以上のクジラが購入	強い収束	高
クジラの購入＋出来高急増	モメンタム確認	非常に高

トークン横断フロー分析

クジラの資金がどこへ流れているかを追跡します。

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)

データソース

Solana のクジラ追跡では、複数のデータソースを使用します。詳しくは references/data_sources.md を参照してください。

ソース	用途	認証が必要
Helius	取引履歴、Webhook	はい（無料プランを利用可能）
SolanaTracker	トップトレーダー、ウォレットの損益	はい
Birdeye	トークン保有者のランキング	はい（無料プランを利用可能）
Solana RPC	トークンアカウント、署名	いいえ（公開エンドポイント）

リアルタイム追跡のための Helius Webhook

Helius Webhook を使うと、ポーリングなしでリアルタイムのクジラアラートを受け取れます。

# 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
}

シグナルの生成

クジラの活動を取引シグナルに変換します。クジラのシグナルは、より広範な意思決定フレームワークにおける入力の一つであり、それだけで取引のトリガーになるものではありません。

シグナルの種類

クジラの買いシグナル：

• クジラが 100 SOL を超える額のトークンを購入します
• 次の要素によって信頼度が高まります：クジラの実績、購入額、購入しているクジラの数
• 次の場合はシグナルを弱めます：トークンが非常に新しい（24 時間未満）、クジラが既知の短期売買者である、集中リスクが高い

クジラの売りシグナル：

• クジラがポジションの 25％超、または 100 SOL 超を売却します
• 次の要素によって信頼度が高まります：複数のクジラによる売却、取引所への送金、売却頻度の増加
• 次の場合はシグナルを弱めます：大きな利益の後に一部利益を確定している、クジラが既知のリバランス実施者である

蓄積シグナル：

• クジラの蓄積スコアが 4 以上です（上記のスコアリングを参照）
• 次の場合に最も強くなります：複数のクジラが同じトークンを蓄積している、価格の下降トレンド中に蓄積している
• 時間軸：数日から数週間（蓄積は緩やかなシグナルです）

分配シグナル：

• クジラの分配スコアが 4 以上です
• 次の場合に最も強くなります：チーム／インサイダーのウォレットが分配している、ロック解除後に分配している、売却ペースが上がっている
• 時間軸：数時間から数日（分配は急速に加速する可能性があります）

シグナルのスコアリング

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",
    }

他のスキルとの連携

クジラの追跡は、他の分析と組み合わせると最も効果を発揮します。

スキル	連携内容
token-holder-analysis	集中リスクとインサイダーのウォレットを特定します
liquidity-analysis	クジラの取引による価格への影響を推定します
solana-onchain	ウォレットのプロファイリングと取引履歴の確認を行います
slippage-modeling	クジラ規模の取引におけるスリッページを予測します
risk-management	クジラの集中度をポジションサイズに反映します
helius-api	取引データの取得と Webhook の設定を行います

ファイル

参考資料

• references/detection_methods.md — 蓄積／分配の検出アルゴリズム、クジラの分類、アラートのしきい値、スコアリングシステム
• references/data_sources.md — クジラの追跡に利用するHelius、SolanaTracker、Birdeye、オンチェーンデータソースの完全ガイド

スクリプト

• scripts/track_whales.py — トークンの上位保有者を取得し、クジラの活動を蓄積／分配／保有に分類して、クジラのレポートを出力します。合成データモードで実行するには、--demo を指定します。
• scripts/whale_alerts.py — クジラのウォレットのウォッチリストを監視して、新たな大口取引を検出し、取引を分類してアラートを出力します。シミュレートしたクジラの取引で実行するには、--demo を指定します。

制限事項と注意点

• プライバシーウォレット：複数のウォレットやミキサーを利用するクジラは、追跡を回避できる場合があります
• 誤解を招くシグナル：クジラが意図的に蓄積を見せかけてフォロワーを誘い、その後売り抜けることがあります
• 遅延：クジラの買いを検出した時点で、価格への影響がすでに織り込まれている可能性があります
• 誤検知：クジラ自身のウォレット間の内部送金が、売買に見えることがあります
• 取引所ウォレット：中央集権型取引所のホットウォレットでは、個々のクジラの活動ではない大規模な資金移動が発生します
• 投資助言ではありません：クジラの活動は分析のための情報であり、それ単独で売買を推奨するものではありません