whalecli_skill

Overview

This skill is an agent-native whale wallet tracker for ETH and BTC chains that surfaces large on-chain movements, scores whale activity, and streams real-time alerts. It closes the loop from on-chain signal to agent reasoning and prediction-market actions by integrating with FearHarvester and Simmer. Use it to pre-validate trades or bets with on-chain evidence and to monitor smart-money accumulation or distribution. The tool exposes CLI commands for scans, streaming, wallet management, alerts, and historical reports.

How this skill works

The skill scans tracked wallets and on-chain sources (Etherscan for ETH, mempool.space/Blockchain.info for BTC) to compute a 0–100 whale score per wallet based on net flow, velocity, correlation, and exchange flow. It can perform one-shot scans or stream JSONL events for real-time monitoring, triggering alerts when scores or USD flows exceed configured thresholds. Agents call the CLI (or subprocess) to fetch parsed JSON results and then apply decision logic (for example, corroborating Fear & Greed signals before placing a Simmer bet).

When to use it

• When a user asks “What are the whales doing?” for ETH or BTC
• Before placing a prediction-market bet or trade to pre-validate with on-chain signals
• To monitor large wallet movements and detect accumulation vs distribution
• As an automated heartbeat during market-active hours to generate alerts
• When corroborating sentiment signals (fear/greed) with on-chain smart-money behavior

Best practices

• Track a curated list of known whale wallets and label them to improve prioritization
• Set sensible thresholds and window sizes (e.g., 4 hours, score ≥70) to reduce noise
• Combine whale signals with sentiment indices or other indicators before automated bets
• Use streaming mode for continuous alerting and scans for scheduled pre-bet checks
• Handle API errors and rate limits gracefully; use provided exit codes to determine retry logic

Example use cases

• Run a 4-hour ETH scan before placing a recovery bet on a prediction market
• Stream real-time whale alerts to a webhook during high-volatility periods
• Pre-bet sanity check: require whales_accumulating before agent places a long trade
• Generate historical reports for a specific whale to analyze 30-day accumulation patterns
• Automate an agent workflow: when fear index is low and whales are accumulating, execute a Simmer bet