whale-watcher

What This Skill Does

Whale Watcher is a powerful tracking tool designed to keep OpenClaw users informed about the activity of 'whale' wallets—large cryptocurrency holders capable of influencing market movements. By monitoring multiple blockchain networks like Ethereum and Binance Smart Chain, this skill provides real-time oversight of capital flow. Whether you are an analyst tracking institutional movements, a day trader monitoring liquidity shifts, or a decentralized finance (DeFi) researcher, Whale Watcher automates the tedious process of cross-referencing ledger data. It allows users to define custom financial thresholds, ensuring that only high-impact transactions trigger notifications, effectively filtering out noise and focusing on significant market events.

Installation

To integrate this skill into your OpenClaw environment, execute the following command in your terminal:

clawhub install openclaw/skills/skills/alexbrc20/whale-watcher

Once installed, you must configure your API access keys to enable on-chain data retrieval. Update your environment variables with valid credentials for the respective explorers:

• export ETHERSCAN_API_KEY="your_key_here"
• export BSCSCAN_API_KEY="your_key_here"

Ensure your shell session is refreshed to apply these changes before invoking the skill.

Use Cases

1. Market Sentiment Analysis: Detect when smart money moves large amounts of stablecoins to exchanges, which often precedes significant sell-offs or buy-ins.
2. DeFi Protocol Monitoring: Track the treasuries of DAO wallets or large liquidity providers to see how they rebalance their portfolios.
3. Early Alerting: Receive immediate Telegram notifications when a dormant whale address suddenly activates or moves substantial assets.
4. Risk Mitigation: Set alerts to be notified when specific collateral wallets fall below safety thresholds in lending protocols.

Example Prompts

1. "Whale Watcher, start monitoring wallet 0x71C7656E... and notify me immediately if any transaction exceeds $500,000 on Ethereum."
2. "Show me the last five transactions for the whale address 0xAb5801a... and tell me the total volume moved."
3. "Set a global alert threshold for all watched wallets to a minimum of 2,000,000 USD to reduce notification spam."

Tips & Limitations

• Threshold Tuning: Don't set your thresholds too low; major whale wallets often have micro-transactions that will overwhelm your alerts. Start high and adjust down.
• Data Latency: While the data is pulled via API, keep in mind there can be slight delays in block indexing across different chains.
• API Limits: Be mindful of the rate limits associated with your Etherscan/BscScan keys. Excessive polling for dozens of wallets simultaneously may trigger account throttling.
• Privacy: Always ensure you are monitoring public addresses. This skill provides transparency on public ledgers but does not de-anonymize private individuals.