ClawKit Logo
ClawKitReliability Toolkit
Back to Registry
Official Verified

whalecli

Agent-native whale wallet tracker for ETH and BTC chains. Track large crypto wallet movements, score whale activity, detect accumulation/distribution patterns, and stream real-time alerts. Integrates with FearHarvester and Simmer prediction markets for closed-loop signal→bet workflows. Use when: user asks about whale activity, on-chain signals, large wallet movements, smart money flows, or when pre-validating crypto trades/bets with on-chain data.

skill-install — Terminal

Install via CLI (Recommended)

clawhub install openclaw/skills/skills/bowen31337/whalecli
Or

WhaleWatch CLI — Agent Skill

Track crypto whale movements. Close the loop from on-chain signal → agent reasoning → prediction market bet.

Install

uv pip install whalecli

Quick Start

# Initialize config (creates ~/.config/whalecli/config.toml)
whalecli config init

# Set API key (free tier: 5 req/sec)
whalecli config set api.etherscan_api_key YOUR_KEY

# Add a whale wallet
whalecli wallet add 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 --label "vitalik.eth" --chain ETH

# Scan all wallets (last 24h)
whalecli scan --format json

# Stream real-time alerts (JSONL, one event per line)
whalecli stream --chain ETH --interval 60

When to Use

Trigger phrases:

  • "What are the whales doing?"
  • "Check whale activity on ETH/BTC"
  • "Are whales accumulating or distributing?"
  • "Any large wallet movements?"
  • "What's the on-chain signal?"
  • "Run a whale scan"

Automatic triggers (no user prompt needed):

  • Every 60 minutes during market-active hours (via heartbeat)
  • Before placing a Simmer/Polymarket bet (pre-bet whale sanity check)
  • When fear/greed index crosses a threshold (corroboration)

CLI Commands

whalecli scan — One-shot whale analysis

whalecli scan --chain ETH --hours 4 --threshold 70 --format json

Output (JSON):

{
  "scan_id": "scan_20260222_103015_a1b2",
  "chain": "ETH",
  "window_hours": 4,
  "wallets": [
    {
      "address": "0xd8dA...",
      "label": "vitalik.eth",
      "score": 82,
      "direction": "accumulating",
      "score_breakdown": {
        "net_flow": 35,
        "velocity": 20,
        "correlation": 15,
        "exchange_flow": 12
      },
      "net_flow_usd": 15000000,
      "tx_count": 12
    }
  ],
  "summary": {
    "total_wallets": 5,
    "accumulating": 3,
    "distributing": 1,
    "neutral": 1,
    "avg_score": 65
  },
  "alerts_triggered": 2
}

whalecli stream — Real-time JSONL streaming

whalecli stream --chain ETH --interval 60 --threshold 70

Events (one JSON per line):

  • stream_start — stream initialized
  • whale_alert — score exceeded threshold
  • whale_activity — activity detected below threshold
  • heartbeat — periodic health check
  • stream_end — clean shutdown

whalecli wallet — Manage tracked wallets

whalecli wallet add 0x... --label "whale1" --chain ETH
whalecli wallet list --format json
whalecli wallet remove 0x...
whalecli wallet import wallets.csv

whalecli alert — Configure alert rules

whalecli alert set --score 75 --webhook https://example.com/hook
whalecli alert set --threshold 1000000 --window 1h
whalecli alert list --format json

whalecli report — Historical analysis

whalecli report --wallet 0x... --days 30 --format json

whalecli config — Configuration management

whalecli config init
whalecli config set api.etherscan_api_key YOUR_KEY
whalecli config show

Exit Codes

Read Full Documentation on GitHub

Metadata

Author@bowen31337
Stars4190
Views4
Updated2026-04-18
View Author Profile
AI Skill Finder

Not sure this is the right skill?

Describe what you want to build — we'll match you to the best skill from 16,000+ options.

Find the right skill
Add to Configuration

Paste this into your clawhub.json to enable this plugin.

{
  "plugins": {
    "official-bowen31337-whalecli": {
      "enabled": true,
      "auto_update": true
    }
  }
}
Safety NoteClawKit audits metadata but not runtime behavior. Use with caution.

Related Skills

Terse

Skill by bowen31337

bowen31337 4190

Identity Resolver

Skill by bowen31337

bowen31337 4190

agent-self-governance

Self-governance protocol for autonomous agents: WAL (Write-Ahead Log), VBR (Verify Before Reporting), ADL (Anti-Divergence Limit), VFM (Value-For-Money), and IKL (Infrastructure Knowledge Logging). Use when: (1) receiving a user correction — log it before responding, (2) making an important decision or analysis — log it before continuing, (3) pre-compaction memory flush — flush the working buffer to WAL, (4) session start — replay unapplied WAL entries to restore lost context, (5) any time you want to ensure something survives compaction, (6) before claiming a task is done — verify it, (7) periodic self-check — am I drifting from my persona? (8) cost tracking — was that expensive operation worth it? (9) discovering infrastructure — log hardware/service specs immediately.

bowen31337 4190

rsi-loop

Recursive Self-Improvement (RSI) loop for EvoClaw agents. Provides a structured observe→analyze→synthesize→deploy pipeline that enables agents to detect their own failure patterns and generate concrete improvement proposals (new skills, routing fixes, SOUL.md updates, memory improvements). Use when: (1) logging a task outcome (success/fail/quality), (2) running periodic self-improvement analysis, (3) reviewing or deploying improvement proposals, (4) integrating RSI into EvoClaw hub/edge agents via MQTT, (5) checking agent health score, (6) any mention of "self-improvement", "recursive improvement", "fix my own mistakes", "improvement loop", or "agent evolution". Core EvoClaw primitive.

bowen31337 4190

clawchain

ClawChain RPC client for EvoClaw agents. Connects to Substrate-based blockchain, queries on-chain agent data, submits transactions, and enables agents to participate in on-chain governance and reputation tracking. Use when working with ClawChain L1 blockchain, agent DIDs, token economics, or agent reputation systems.

bowen31337 4190