mcpField
W
whale-tracking

whale-tracking

github.com/agiprolabs数据与数据库456498 次安装8 周前更新
代码仓库

关于 whale-tracking

whale-tracking 是分析 Solana 代币大额钱包活动的技能。它为链上分析人员和交易者提供模式分类方法与脚本,用于识别累积、分发和大额交易,并将信号作为分析信息而非独立建议。

主要功能

  1. 01分类累积与分发模式
  2. 02管理钱包观察列表和标签
  3. 03跨代币分析巨鲸活动
  4. 04生成买入、卖出和资金流信号
  5. 05追踪持仓与告警脚本

适用场景

  1. 01评估代币持仓集中风险
  2. 02监控观察钱包的大额交易
  3. 03比较不同代币的巨鲸活动

安装

复制下面的命令,在终端中运行。

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

安装后在 Claude Code 中输入/whale-tracking确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

references/
data_sources.md
detection_methods.md
scripts/
track_whales.py
whale_alerts.py

详细介绍

Solana 代币巨鲸追踪

巨鲸追踪会监控大额钱包的链上行为,以便在其影响反映到价格走势之前,发现增持、分发和聪明资金动向。在 Solana 上,代币持有权高度集中,巨鲸交易可能瞬间撼动市场,因此追踪大户是目前最有效的 Alpha 来源之一。

巨鲸追踪的重要性

单个大额钱包卖出某代币 5% 的供应量,就可能在 Solana DEX 流动性不足时导致价格暴跌 30-50%。反之,已知盈利能力强的钱包增持新代币,往往预示着价格即将大幅上涨。巨鲸追踪将链上透明度转化为可执行的情报。

主要用途:

  • 提前预警:在价格影响完全显现之前,发现大户卖出
  • 跟随聪明资金:识别业绩出色的钱包,并监控其新仓位
  • 发现增持:发现巨鲸为避免被察觉而拆分订单、逐步买入的行为
  • 发现分发:发现内部人士或早期投资者正在抛售仓位
  • 风险评估:建仓前评估代币的持仓集中风险

如何界定巨鲸

巨鲸的判定取决于具体情况。持有价值 5 万美元、对应市值 100 万美元代币的钱包属于巨鲸;持有同样价值的 SOL 则不算。请结合相对和绝对阈值:

绝对阈值
类别交易规模投资组合规模典型行为
散户< 10 SOL< 100 SOL反应式交易,追随趋势
中等规模10-100 SOL100-1,000 SOL策略多样
巨鲸100-1,000 SOL1,000-10,000 SOL掌握信息,影响市场
超级巨鲸> 1,000 SOL> 10,000 SOL做市商、基金、内部人士
相对阈值(按代币计算)
指标阈值重要性
持有供应量占比> 2%重要持有者
占日交易量比例单笔交易 > 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
分发信号

分发是指巨鲸减少或退出仓位,通常会逐步操作以避免价格暴跌。

逐步卖出:

  • 数天内多次卖出,每次 < 仓位的 5%
  • 卖出频率逐渐增加
  • 仓位持续缩小

转入交易所:

  • 代币转入已知的交易所充值地址
  • 大额转入 Binance、OKX、Bybit 热钱包
  • 通常会在数小时或数天后开始卖出

快速退出:

  • 单笔大额市价卖出(> 仓位的 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
  • 以下因素会提高置信度:巨鲸过往表现、买入规模、买入的巨鲸数量
  • 以下情况会削弱信号:代币非常新(< 24h)、巨鲸被认为是短线获利者、集中度风险高

巨鲸卖出信号:

  • 巨鲸卖出超过 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 模拟巨鲸交易。

局限性和注意事项

  • 隐私钱包:使用多个钱包或混币器的巨鲸可能会避开追踪
  • 误导性信号:巨鲸可能故意制造明显的累积行为来吸引跟随者,然后抛售
  • 延迟:检测到巨鲸买入时,价格影响可能已经反映在价格中
  • 误报:巨鲸自有钱包之间的内部转账看起来像买入/卖出
  • 交易所钱包:中心化交易所热钱包会显示大量资金流动,但并非个人巨鲸活动
  • 非财务建议:巨鲸活动是分析时的参考信息,不能单独作为交易建议

评论

支持 Markdown