monitoring-whale-activity

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Monitoring Whale Activity

鲸鱼活动监控

Overview

概述

Track large cryptocurrency transactions and whale wallet movements across multiple blockchains. Monitor exchange inflows/outflows, manage watchlists, and identify known wallets (exchanges, funds, bridges).

跨多条区块链追踪加密货币大额交易及鲸鱼钱包动向。监控交易所资金流入/流出、管理观察列表，并识别已知钱包（交易所、基金、跨链桥）。

Prerequisites

前提条件

Before using this skill, ensure you have:

Python 3.8+ with requests library
Whale Alert API key (optional, for live data - free tier available)
Internet access for API calls

使用本技能前，请确保您已具备：

安装有requests库的Python 3.8+
Whale Alert API密钥（可选，用于获取实时数据 - 提供免费层级）
可进行API调用的网络访问权限

Instructions

操作步骤

Step 1: Navigate to Scripts Directory

步骤1：导航至脚本目录

bash

cd {baseDir}/scripts

bash

cd {baseDir}/scripts

Step 2: Choose Your Command

步骤2：选择对应命令

Recent Whale Transactions:

bash

python whale_monitor.py recent                    # All chains
python whale_monitor.py recent --chain ethereum   # Specific chain
python whale_monitor.py recent --min-value 10000000  # $10M+ only

Exchange Flow Analysis:

bash

python whale_monitor.py flows                     # Overall exchange flows
python whale_monitor.py flows --chain ethereum    # Chain-specific

Watchlist Management:

bash

python whale_monitor.py watchlist                 # View watchlist
python whale_monitor.py watch 0x123... --name "My Whale"  # Add to watchlist
python whale_monitor.py unwatch 0x123...          # Remove from watchlist

Track Specific Wallet:

bash

python whale_monitor.py track 0x123...            # Track wallet activity

Search Known Labels:

bash

python whale_monitor.py labels --query binance    # Search by name
python whale_monitor.py labels --type exchange    # List by type

近期鲸鱼交易：

bash

python whale_monitor.py recent                    # 全链查询
python whale_monitor.py recent --chain ethereum   # 指定以太坊链
python whale_monitor.py recent --min-value 10000000  # 仅查询1000万美元以上交易

交易所资金流分析：

bash

python whale_monitor.py flows                     # 整体交易所资金流
python whale_monitor.py flows --chain ethereum    # 指定链的资金流

观察列表管理：

bash

python whale_monitor.py watchlist                 # 查看观察列表
python whale_monitor.py watch 0x123... --name "My Whale"  # 添加至观察列表
python whale_monitor.py unwatch 0x123...          # 从观察列表移除

追踪特定钱包：

bash

python whale_monitor.py track 0x123...            # 追踪钱包活动

搜索已知标签：

bash

python whale_monitor.py labels --query binance    # 按名称搜索
python whale_monitor.py labels --type exchange    # 按类型列出

Step 3: Interpret Results

步骤3：结果解读

Transaction Types:

🔴 DEPOSIT → Exchange (potential selling pressure)
🟢 WITHDRAWAL → From exchange (accumulation signal)
🐋 TRANSFER → Wallet to wallet (whale movement)

Flow Analysis:

Net positive flow to exchanges = selling pressure
Net negative flow from exchanges = buying pressure

交易类型：

🔴 DEPOSIT → 存入交易所（潜在抛售压力）
🟢 WITHDRAWAL → 从交易所提币（积累信号）
🐋 TRANSFER → 钱包间转账（鲸鱼动向）

资金流分析：

净流入交易所 = 抛售压力
净流出交易所 = 买入压力

Output

输出内容

Real-time whale transactions with USD values
Labeled wallets (exchanges, funds, bridges, protocols)
Exchange inflow/outflow summaries
Custom watchlist tracking
JSON, table, or alert format output

带美元价值的实时鲸鱼交易数据
已标记的钱包（交易所、基金、跨链桥、协议）
交易所资金流入/流出汇总
自定义观察列表追踪
JSON、表格或告警格式的输出

Error Handling

错误处理

See

{baseDir}/references/errors.md

for:

API rate limit handling
Network timeout recovery
Invalid address formats
Price service fallbacks

请查看

{baseDir}/references/errors.md

了解：

API调用频率限制处理
网络超时恢复
无效地址格式处理
价格服务降级方案

Examples

示例

View $10M+ whale transactions on Ethereum:

bash

python whale_monitor.py recent --chain ethereum --min-value 10000000

Analyze if whales are selling (depositing to exchanges):

bash

python whale_monitor.py flows --chain ethereum

Track a known whale wallet:

bash

python whale_monitor.py watch 0x28c6c... --name "Binance Cold"
python whale_monitor.py track 0x28c6c...

Export to JSON for further analysis:

bash

python whale_monitor.py recent --format json > whales.json

See

{baseDir}/references/examples.md

for more usage patterns.

查看以太坊链上1000万美元以上的鲸鱼交易：

bash

python whale_monitor.py recent --chain ethereum --min-value 10000000

分析鲸鱼是否在抛售（存入交易所）：

bash

python whale_monitor.py flows --chain ethereum

追踪已知鲸鱼钱包：

bash

python whale_monitor.py watch 0x28c6c... --name "Binance Cold"
python whale_monitor.py track 0x28c6c...

导出为JSON格式以便进一步分析：

bash

python whale_monitor.py recent --format json > whales.json

更多使用模式请查看

{baseDir}/references/examples.md

。

Resources

参考资源

Whale Alert - Real-time whale transaction API
Etherscan - Ethereum blockchain explorer
CoinGecko - Price data API
Known wallet database with 100+ labeled exchanges and protocols

Whale Alert - 实时鲸鱼交易API
Etherscan - 以太坊区块链浏览器
CoinGecko - 价格数据API
包含100+已标记交易所及协议的已知钱包数据库