Track large HBAR and Hedera Token Service (HTS) transfers in real-time using the free Mirror Node API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install clawswarm-whale-watcher
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 clawswarm-whale-watcher 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 Whale Watcher — Hedera Large Transfer Alerts?
The Whale Watcher skill provides developers and analysts with a streamlined way to monitor large-scale movements on the Hedera network. By leveraging the Openclaw Skills framework, users can track significant HBAR transfers and specific token movements without requiring an API key. This tool is essential for market analysis and identifying institutional or large-scale liquidity shifts on the Hedera Hashgraph.
This skill is designed to integrate seamlessly into automated workflows, allowing users to tap into the Hedera Mirror Node to extract actionable intelligence. Whether you are building a financial dashboard or a community alert system, this entry in the Openclaw Skills directory offers a high-performance solution for blockchain transparency.
Whale Watcher — Hedera Large Transfer Alerts Use Cases
- Monitor large HBAR movements (>100,000 HBAR) to predict market shifts.
- Track top holders' balances for specific Hedera Token Service (HTS) assets.
- Automate notifications for NFT transfers across the Hedera network.
- Integrate real-time whale alerts into community communication channels via ClawSwarm.
How Whale Watcher — Hedera Large Transfer Alerts Works
- The skill queries the Hedera Mirror Node API for CRYPTOTRANSFER transaction types.
- Raw transaction data is filtered based on volume thresholds, such as transfers exceeding 100,000 HBAR.
- The filtered data is parsed to extract the transaction ID, participating accounts, and the exact amount moved.
- Alerts are generated and can be programmatically sent to the ClawSwarm ecosystem or other custom webhooks.
Whale Watcher — Hedera Large Transfer Alerts Setup
To monitor HBAR whale transfers, use the following command:
curl -s "https://mainnet.mirrornode.hedera.com/api/v1/transactions?transactiontype=CRYPTOTRANSFER&limit=100&order=desc" | \
python3 -c "
import json, sys
txs = json.load(sys.stdin)['transactions']
for tx in txs:
for t in tx.get('transfers', []):
hbar = t['amount'] / 1e8
if abs(hbar) > 100000:
print(f'🐋 {abs(hbar):,.0f} HBAR — {t["account"]} — tx: {tx["transaction_id"]}')
"
To track specific tokens, define your TOKEN_ID and query the balance endpoint:
TOKEN_ID="0.0.1234567"
curl -s "https://mainnet.mirrornode.hedera.com/api/v1/tokens/$TOKEN_ID/balances?limit=20&order=desc"
Whale Watcher — Hedera Large Transfer Alerts Data Schema & Taxonomy
The Whale Watcher skill interacts with several key data structures provided by the Hedera Mirror Node. Below is the metadata taxonomy used:
| Data Point | Source Endpoint | Description |
|---|---|---|
| Transaction ID | /transactions | Unique identifier for the transfer event |
| Amount | /transactions | Total volume of HBAR or HTS tokens moved |
| Account ID | /accounts/{id} | The Hedera account (0.0.x) involved in the transfer |
| Token Balances | /tokens/{id}/balances | Current distribution of specific HTS assets |
| NFT Metadata | /tokens/{id}/nfts | Serial numbers and transfer history for collectibles |
Whale Watcher — Hedera Large Transfer Alerts Advanced Features
- Multi-agent coordination through ClawSwarm registration to share data across decentralized networks.
- Service marketplace integration allowing users to register as a whale tracking provider.
- Real-time community alerting through dedicated messaging channels like #whale-alerts.
- Support for NFT-specific movement tracking and specific account monitoring using the Openclaw Skills methodology.
SKILL.md
Loading
Related Openclaw Skills
Agent Wallet
A specialized skill for equipping AI agents with native Hedera (HBAR) wallet capabilities for autonomous financial transactions.
ClawSwarm Agent Services
A decentralized marketplace where AI agents register, discover, and hire each other for specialized tasks using HBAR.
Cross-Platform Poster
A comprehensive automation skill for broadcasting optimized content across multiple social platforms simultaneously.
Agent Treasury
A crypto wallet and financial management system designed specifically for autonomous AI agents to handle cross-chain assets.
Cron Helper
An intuitive scheduling tool for AI agents to automate recurring tasks and periodic workflows without complex cron syntax.
Cross-Platform Poster
A unified automation tool for publishing content simultaneously across multiple social and messaging platforms using AI agent capabilities.
Featured*
