An agent-native whale wallet tracker for monitoring large BTC and ETH movements and scoring smart money activity.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install whalecli
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install whalecli using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is whalecli?
whalecli is a specialized command-line tool designed to empower developers using Openclaw Skills with deep insights into on-chain whale activity. By tracking high-value wallets across Ethereum, Bitcoin, and Hyperliquid, this skill identifies accumulation and distribution patterns that often precede major market moves. It functions as a bridge between raw blockchain data and agent-driven reasoning, allowing for automated signal detection and real-time response.
Built to integrate seamlessly into a wider ecosystem, it provides structured data that helps agents validate market sentiment and execute complex workflows. Whether you are building a trading bot or a market research assistant, whalecli provides the transparency needed to understand what the largest players in the crypto space are doing in real-time.
whalecli Use Cases
- Tracking smart money accumulation or distribution patterns on ETH and BTC to inform trading strategies.
- Implementing a pre-bet sanity check for prediction markets by analyzing recent whale movements.
- Automating real-time alerts for large wallet transfers via webhooks within the Openclaw Skills framework.
- Corroborating social sentiment data with actual on-chain flow to identify high-conviction market signals.
- Monitoring Hyperliquid perpetual fills and positions for institutional-grade market analysis.
How whalecli Works
- Users configure the tool by adding specific blockchain addresses to a tracking list and providing necessary API keys.
- The skill fetches transaction data from explorers like Etherscan and Mempool.space based on user-defined time windows.
- A multi-dimensional scoring algorithm analyzes net flow, transaction velocity, peer correlation, and exchange registry data.
- The system determines a score from 0-100, classifying the activity as accumulating, distributing, or neutral.
- Results are output as structured JSON or streamed as JSONL, allowing Openclaw Skills agents to parse and act on the data immediately.
whalecli Setup
To integrate this capability into your Openclaw Skills environment, install the package and initialize your configuration:
uv pip install whalecli
whalecli config init
whalecli config set api.etherscan_api_key YOUR_KEY
Add your first wallet to track:
whalecli wallet add 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 --label "vitalik.eth" --chain ETH
whalecli Data Schema & Taxonomy
The skill produces detailed JSON reports to ensure compatibility with various automation tools. The data includes:
| Attribute | Description |
|---|---|
scan_id |
Unique session identifier for the analysis |
score |
A 0-100 confidence score based on the scoring algorithm |
direction |
The detected activity type (e.g., accumulating or distributing) |
net_flow_usd |
The total USD value moved during the specified window |
score_breakdown |
Granular metrics for net flow, velocity, correlation, and exchange flow |
whalecli Advanced Features
- Real-time JSONL streaming for event-driven agent architectures.
- Automated webhook support for high-threshold whale alerts.
- Closed-loop integration with FearHarvester and Simmer for advanced contrarian betting strategies.
- Multi-chain support including Ethereum (ETH), Bitcoin (BTC), and Hyperliquid (HL).
- Historical reporting capabilities to analyze long-term wallet behavior over 30-day periods.
SKILL.md
Loading
Related Openclaw Skills
WEEX Futures Trading
A high-performance AI agent skill for executing USDT-margined perpetual futures trades on the WEEX exchange with up to 125x leverage.
TypeScript LSP
A powerful language server providing deep code intelligence, type checking, and refactoring for TypeScript and JavaScript projects.
Tiered Memory System
A sophisticated three-tier memory architecture that mimics human cognition to provide AI agents with efficient, hierarchical, and long-term context retention.
Solidity LSP
A comprehensive language server integration for Solidity that provides compilation, linting, and security auditing for smart contract developers.
Discord Chat
A comprehensive communication skill enabling AI agents to interact with Discord channels through messages, replies, reactions, and advanced history searching.
AIresearchOS
AIresearchOS is a deep research engine that enables users to submit complex queries and receive comprehensive, multi-source reports directly within an agent workflow.
Featured*
