name: 鲸鱼追踪 description: “监控 Polymarket 和加密货币链（Solana, ETH, Polygon, ARB, Base, OP）上的大额交易” emoji: “🐋” gates: envs: anyOf: - POLY_API_KEY - BIRDEYE_API_KEY - ALCHEMY_API_KEY
鲸鱼追踪 - 完整 API 参考
监控 Polymarket 和加密货币链上的大额交易和持仓，以识别市场活动。
支持的平台
预测市场
- Polymarket - WebSocket 实时交易监控
加密货币链
| 链 | 提供者 | 功能 |
|---|---|---|
| Solana | Birdeye WebSocket | 代币转账、交换、NFT |
| Ethereum | Alchemy WebSocket | ERC-20、ETH 转账 |
| Polygon | Alchemy WebSocket | MATIC、代币 |
| Arbitrum | Alchemy WebSocket | L2 活动 |
| Base | Alchemy WebSocket | Coinbase L2 |
| Optimism | Alchemy WebSocket | OP 生态系统 |
聊天命令
Polymarket 鲸鱼追踪
/whale start # 开始鲸鱼监控
/whale stop # 停止监控
/whale track <address> # 跟踪特定钱包
/whale untrack <address> # 停止跟踪钱包
/whale top 10 # 按交易量排名前 10 的交易者
/whale top 10 --period 7d # 过去 7 天内的前 10 名
/whale activity <market> # 市场的鲸鱼活动
/whale activity "trump" # 按关键词搜索
/whale recent 20 # 最近 20 笔鲸鱼交易
/whale recent 20 --min-size 10000 # 最小 $10k 交易
加密货币鲸鱼追踪
/crypto-whale start # 开始加密货币鲸鱼追踪
/crypto-whale stop # 停止追踪
/crypto-whale watch solana <address> # 监控 Solana 钱包
/crypto-whale watch eth <address> # 监控 Ethereum 钱包
/crypto-whale unwatch <address> # 停止监控
/crypto-whale top solana 10 # Solana 前 10 名鲸鱼
/crypto-whale top eth 10 # ETH 前 10 名鲸鱼
/crypto-whale recent solana 20 # 最近 Solana 鲸鱼交易
/crypto-whale recent eth 20 # 最近 ETH 鲸鱼交易
/crypto-whale thresholds # 查看当前阈值
/crypto-whale threshold solana 50000 # 设置 Solana 阈值为 $50k
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(`🐋 Whale ${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(` P&L: $${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(` P&L: $${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.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,
});
最佳实践
- 设置合理的阈值 - 从活跃市场的 $10k 开始
- 关注特定市场 - 按类别过滤以减少噪音
- 追踪已知的聪明资金 - 跟踪有良好记录的钱包
- 结合跟单交易 - 使用鲸鱼数据来指导跟单决策
- 监控情绪变化 - 观察净鲸鱼方向变化
- 检查持仓大小 - 大持仓表示信心