← Back to Skills Marketplace
waleolapo

Crypto Whale Monitor

by waleolapo · GitHub ↗ · v1.0.3
cross-platform ⚠ suspicious
2981
Downloads
5
Stars
11
Active Installs
4
Versions
Install in OpenClaw
/install 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....
README (SKILL.md)

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.
Usage Guidance
This skill is coherent with its stated purpose, but review these practical points before running: - Inspect the script (scripts/monitor.js) yourself — it only reads references/wallets.md or CLI args and posts JSON-RPC requests to the configured RPC_URL (default: https://eth.llamarpc.com). - RPC_URL is optional but can be set; avoid pointing it at unknown or untrusted endpoints if you care about exposing which addresses you query. - No credentials are requested; the tool only prints balances to stdout. If you schedule it (cron), consider where logs go (avoid sending outputs to public locations). - Ensure you run it with a recent Node version (Node 18+ provides global fetch) or run with a fetch polyfill. - For extra caution, run it in an isolated environment with restricted network egress if you want to limit outbound connections.
Capability Analysis
Type: OpenClaw Skill Name: crypto-whale-monitor Version: 1.0.3 The skill's code (`scripts/monitor.js`) is benign, performing its stated function of monitoring cryptocurrency wallets using public RPCs without any malicious actions or vulnerabilities. However, the `SKILL.md` file contains a direct instruction to the AI agent: 'Set up a cron job to run `npm start` periodically for automated monitoring.' While the stated objective of automated monitoring is aligned with the skill's purpose, this instruction represents a prompt injection risk, as it directs the agent to modify system persistence (cron job). This capability, even with a benign stated intent, is a high-risk behavior for an AI agent and could be abused if the agent is overly permissive or the instruction were subtly altered.
Capability Assessment
Purpose & Capability
Name/description align with implementation: the script reads wallet addresses (from references/wallets.md or CLI args), queries an Ethereum JSON-RPC endpoint for balances, and alerts above a threshold. The bundled fallback addresses are reasonable examples. No unrelated credentials, binaries, or config paths are requested.
Instruction Scope
SKILL.md instructs running the provided Node script and reading references/wallets.md, which matches the script's behavior. The script only reads the included wallets file (or CLI args) and issues JSON-RPC POST requests to the configured RPC endpoint, then prints results to stdout. There is no evidence it reads other system files or transmits data to unexpected endpoints.
Install Mechanism
No install spec is provided (instruction-only plus a script), so nothing is downloaded or installed by the skill itself. This is lowest-risk for code installation. The only runtime dependency is Node to run the script.
Credentials
The skill requires no secrets. It accepts an optional RPC_URL environment variable (not mandatory) to override the default public endpoint (https://eth.llamarpc.com). The metadata declares no required env vars; this is acceptable since RPC_URL is optional, but users should be aware they can point it at any RPC (including private or malicious endpoints) which will receive the addresses being queried.
Persistence & Privilege
The skill does not request always:true, does not modify other skills or system settings, and is invoked by the user. It performs no persistent or privileged operations beyond reading its own references/wallets.md file.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install crypto-whale-monitor
  3. After installation, invoke the skill by name or use /crypto-whale-monitor
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.3
- No user-visible changes; updated internal logic in scripts/monitor.js. - SKILL.md and overall documentation remain unchanged.
v1.0.2
- Updated monitoring logic to scan wallet balances using Web3 RPC instead of relying on Etherscan. - Added support for reading whale wallet addresses from `references/wallets.md` or accepting custom addresses. - Introduced `npm start` entry point for easier execution and automation. - Improved documentation to clarify usage steps and new monitoring workflow. - Added `_meta.json` and `package.json` files to support package management and metadata.
v1.0.1
- Updated scripts/monitor.js with minor changes. - No user-facing features or documentation updates.
v1.0.0
Initial Launch of Wallet Monitor
Metadata
Slug crypto-whale-monitor
Version 1.0.3
License
All-time Installs 11
Active Installs 11
Total Versions 4
Frequently Asked Questions

What is Crypto Whale Monitor?

Monitors large cryptocurrency wallet balances (whales) on-chain using Web3 RPC to detect potential market-moving activity. Can read from `references/wallets.... It is an AI Agent Skill for Claude Code / OpenClaw, with 2981 downloads so far.

How do I install Crypto Whale Monitor?

Run "/install crypto-whale-monitor" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Crypto Whale Monitor free?

Yes, Crypto Whale Monitor is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Crypto Whale Monitor support?

Crypto Whale Monitor is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Crypto Whale Monitor?

It is built and maintained by waleolapo (@waleolapo); the current version is v1.0.3.

💬 Comments