whale-tracking whale-tracking

监控Polymarket和加密货币链上的大额交易和头寸,识别市场动态活动。

算法交易 0 次安装 0 次浏览 更新于 3/5/2026

监控Polymarket和加密货币链(Solana, ETH, Polygon, ARB, Base, OP)上的鲸鱼交易。

支持平台

预测市场

  • Polymarket - WebSocket实时交易监控

加密货币链

提供者 特性
Solana Birdeye WebSocket 代币转账,交换,NFTs
Ethereum Alchemy WebSocket ERC-20, ETH转账
Polygon Alchemy WebSocket MATIC, 代币
Arbitrum Alchemy WebSocket L2活动
Base Alchemy WebSocket Coinbase L2
Optimism Alchemy WebSocket OP生态系统

聊天命令

通用

/whale                                      # 活跃鲸鱼警报摘要
/whale start                                # 开始鲸鱼监控
/whale stop                                 # 停止监控
/whale config                               # 跟踪配置
/whale list                                 # 列出跟踪的钱包

跟踪钱包

/whale track <address>                      # 关注特定钱包
/whale untrack <address>                    # 停止关注钱包
/whale watch <address> [--chain c]          # 跟踪一个地址(同track)
/whale unwatch <address>                    # 停止跟踪(同untrack)

Polymarket鲸鱼活动

/whale polymarket [n]                       # 最近Polymarket鲸鱼交易
/whale polymarket market <id>               # 市场的鲸鱼活动
/whale activity <market>                    # 市场的鲸鱼活动
/whale recent [n] [--min-size N]            # 最后N笔鲸鱼交易
/whale top [n]                              # Polymarket顶级鲸鱼
/whale profitable [wr%] [min-n]             # 盈利鲸鱼
/whale profile <address>                    # 鲸鱼资料+位置
/whale positions [market-id]                # 活跃鲸鱼位置

加密鲸鱼跟踪

/whale crypto [chain] [n]                   # 链上鲸鱼交易
/whale top crypto [chain] [n]               # 链上顶级鲸鱼

注意:/whales也作为/whale的别名。


TypeScript API参考

Polymarket鲸鱼跟踪器

import { createWhaleTracker, isWhaleAddress, getMarketWhaleActivity } from 'clodds/feeds/polymarket/whale-tracker';

// 创建跟踪器
const tracker = createWhaleTracker({
  minTradeSize: 10000,      // $10k+交易
  minPositionSize: 50000,   // $50k+位置
  enableRealtime: true,     // WebSocket流
});

// 事件处理程序
tracker.on('trade', (trade) => {
  console.log(`🐋 鲸鱼 ${trade.side} $${trade.usdValue.toLocaleString()}`);
  console.log(`  市场: ${trade.marketQuestion}`);
  console.log(`  地址: ${trade.address}`);
  console.log(`  价格: ${trade.price}`);
});

tracker.on('positionOpened', (position) => {
  console.log(`📈 新鲸鱼位置`);
  console.log(`  地址: ${position.address}`);
  console.log(`  市场: ${position.market}`);
  console.log(`  大小: $${position.size.toLocaleString()}`);
});

tracker.on('positionClosed', (position) => {
  console.log(`📉 鲸鱼退出位置`);
  console.log(`  盈亏: $${position.pnl.toLocaleString()}`);
});

// 开始跟踪
await tracker.start();

// 跟踪特定钱包
await tracker.trackAddress('0x1234...');
await tracker.untrackAddress('0x1234...');

// 获取跟踪地址
const tracked = tracker.getTrackedAddresses();

// 停止跟踪
await tracker.stop();

检查鲸鱼状态

// 检查地址是否为鲸鱼
const isWhale = await isWhaleAddress('0x1234...', 100000);  // $100k最小体积

// 获取市场的鲸鱼活动
const activity = await getMarketWhaleActivity('market-slug');

console.log(`总鲸鱼体积: $${activity.totalVolume.toLocaleString()}`);
console.log(`鲸鱼交易: ${activity.tradeCount}`);
console.log(`净鲸鱼情绪: ${activity.sentiment}`);  // 'bullish' | 'bearish' | 'neutral'
console.log(`顶级鲸鱼:`);
for (const whale of activity.topWhales) {
  console.log(`  ${whale.address}: $${whale.volume.toLocaleString()}`);
}

顶级交易者

// 获取顶级交易者
const topTraders = await tracker.getTopTraders({
  period: '7d',           // 24h, 7d, 30d, all
  limit: 10,
  minVolume: 50000,
  minWinRate: 0.5,
});

for (const trader of topTraders) {
  console.log(`${trader.rank}. ${trader.address}`);
  console.log(`   体积: $${trader.volume.toLocaleString()}`);
  console.log(`   胜率: ${(trader.winRate * 100).toFixed(1)}%`);
  console.log(`   盈亏: $${trader.pnl.toLocaleString()}`);
}

加密鲸鱼跟踪器

import { createCryptoWhaleTracker } from 'clodds/feeds/crypto/whale-tracker';

// 创建多链跟踪器
const cryptoTracker = createCryptoWhaleTracker({
  chains: ['solana', 'ethereum', 'polygon', 'arbitrum', 'base', 'optimism'],

  thresholds: {
    solana: 10000,      // Solana上的$10k+
    ethereum: 50000,    // ETH上的$50k+
    polygon: 5000,      // Polygon上的$5k+
    arbitrum: 10000,    // Arbitrum上的$10k+
    base: 10000,        // Base上的$10k+
    optimism: 10000,    // Optimism上的$10k+
  },

  // API密钥
  birdeyeApiKey: process.env.BIRDEYE_API_KEY,
  alchemyApiKey: process.env.ALCHEMY_API_KEY,
});

// 事件处理程序
cryptoTracker.on('transaction', (tx) => {
  console.log(`🐋 ${tx.chain.toUpperCase()}`);
  console.log(`   类型: ${tx.type}`);  // 'transfer', 'swap', 'nft', 'stake'
  console.log(`   金额: $${tx.usdValue.toLocaleString()}`);
  console.log(`   来自: ${tx.from}`);
  console.log(`   至: ${tx.to}`);
  console.log(`   代币: ${tx.token}`);
  console.log(`   TX: ${tx.hash}`);
});

cryptoTracker.on('largeTransfer', (tx) => {
  console.log(`🚨 大额转账: $${tx.usdValue.toLocaleString()}`);
});

// 开始跟踪
await cryptoTracker.start();

// 观察特定钱包
await cryptoTracker.watchWallet('solana', 'ABC123...');
await cryptoTracker.watchWallet('ethereum', '0x1234...');

// 取消观察
await cryptoTracker.unwatchWallet('solana', 'ABC123...');

// 获取最近的鲸鱼交易
const recent = await cryptoTracker.getRecentTransactions('solana', {
  limit: 20,
  minValue: 50000,
});

// 获取链上的顶级鲸鱼
const topSolana = await cryptoTracker.getTopWhales('solana', 10);
const topEth = await cryptoTracker.getTopWhales('ethereum', 10);

// 停止
await cryptoTracker.stop();

警报配置

Polymarket警报

// 配置警报
tracker.setAlertConfig({
  minTradeSize: 25000,      // 警报$25k+交易
  alertChannels: ['telegram', 'discord'],
  soundEnabled: true,
  markets: ['politics', 'crypto'],  // 按类别过滤
});

加密警报

// 按链配置
cryptoTracker.setAlertConfig({
  solana: {
    minValue: 50000,
    tokens: ['SOL', 'JUP', 'BONK'],
  },
  ethereum: {
    minValue: 100000,
    tokens: ['ETH', 'USDC', 'PEPE'],
  },
});

数据导出

// 导出鲸鱼数据到CSV
await tracker.exportTrades({
  format: 'csv',
  path: './whale-trades.csv',
  period: '30d',
});

// 导出顶级交易者
await tracker.exportTopTraders({
  format: 'json',
  path: './top-traders.json',
  limit: 100,
});

最佳实践

  1. 设置合理的阈值 - 从活跃市场的$10k开始
  2. 专注于特定市场 - 按类别过滤以减少噪音
  3. 跟踪已知的智能资金 - 关注有良好记录的钱包
  4. 结合复制交易 - 使用鲸鱼数据来通知复制决策
  5. 监控情绪变化 - 观察鲸鱼方向的变化
  6. 检查位置大小 - 大位置信号信念