home / skills / openclaw / skills / crypto-whale-monitor

crypto-whale-monitor skill

unsafe

This skill monitors large cryptocurrency wallet transactions in real time and alerts you when whale activity crosses your threshold.

npx playbooks add skill openclaw/skills --skill crypto-whale-monitor

Review the files below or copy the command above to add this skill to your agents.

Files (5)

SKILL.md

933 B

---
name: crypto-whale-monitor
description: Monitors large cryptocurrency wallet balances (whales) on-chain using Web3 RPC to detect potential market-moving activity. Can read from `references/wallets.md` or accept custom addresses.
---

# Crypto Whale Monitor

This skill contains the logic to connect to blockchain explorers and track large balances for a defined set of "whale" wallets.

## Workflow

1. **Define Wallets**: Add known whale addresses to `references/wallets.md`.
2. **Execute**: Run `npm start` (or `./scripts/monitor.js`) to scan the list.
3. **Analyze**: Review output for "WHALE DETECTED" alerts.
4. **Schedule**: Set up a cron job to run `npm start` periodically for automated monitoring.

## Scripts
- `scripts/monitor.js`: Core logic for checking balances via public RPC. Reads from `references/wallets.md` by default.

## References
- `references/wallets.md`: A list of known, public whale wallet addresses.

Overview

This skill monitors large cryptocurrency wallet transactions (whales) on-chain and alerts you when activity exceeds defined thresholds. It connects to blockchain explorer APIs to scan specified wallet addresses and identifies potentially market-moving transfers. Use it to get timely notifications for high-value movements that may affect token prices or liquidity.

How this skill works

You provide a list of target wallet addresses and a transaction-size threshold. The skill queries on-chain data via Web3-compatible providers and Etherscan/Alchemy APIs, parses transfers and token movements, and flags transactions that exceed the threshold. It can be run on demand or scheduled as a cron job to produce periodic checks and trigger alerts.

When to use it

You want real-time or periodic alerts for large transfers from known whale addresses.
Monitoring specific tokens or stablecoin flows that can influence market sentiment.
Wallet compliance or forensic investigations that need high-value transfer tracking.
Portfolio managers who want early signals for potential market volatility.
When automating notification pipelines for trading or risk systems.

Best practices

Maintain an up-to-date list of target wallet addresses and validate them before monitoring.
Set thresholds appropriate to token liquidity and typical transfer sizes to reduce noise.
Use reliable API keys (Etherscan/Alchemy) and handle rate limits with backoff and caching.
Schedule frequent checks for fast-moving markets, but balance frequency with API costs.
Log all detected events with timestamps, transaction hashes, and token details for audits.

Example use cases

Alert trading desk when a known whale moves > $1,000,000 USDT out of a liquidity pool.
Feed whale transfer events into a dashboard that correlates transfers with price spikes.
Trigger an automated hedging workflow when large outgoing transfers are detected.
Compliance team flags suspicious large transfers from a watchlist of addresses.
Backstop risk controls by pausing automated trades when multiple whales move funds concurrently.

FAQ

Can this monitor tokens other than ETH?

Yes. The skill inspects ERC-20 token transfers via on-chain logs and token contract events in addition to native ETH transfers.

How do I avoid API rate limits?

Use API keys from providers like Alchemy/Etherscan, implement caching of recent blocks, and apply exponential backoff on retries.