← Back to Skills Marketplace
0xraini

Crypto Watcher

by 0xRaini · GitHub ↗ · v1.0.0
cross-platform ✓ Security Clean
1132
Downloads
3
Stars
6
Active Installs
1
Versions
Install in OpenClaw
/install crypto-watcher
Description
Monitor ETH wallets and DeFi positions across chains with alerts for balance changes, gas prices, health factors, and large token transfers.
README (SKILL.md)

crypto-watcher

Monitor crypto wallets and DeFi positions. Get alerts when things change.

Features

  • Wallet tracking: ETH + token balances across chains
  • DeFi positions: LP positions, lending health, staking rewards
  • Gas alerts: Notify when gas is cheap for transactions
  • Whale alerts: Large transfers on watched tokens

Usage

Setup

# Add a wallet to watch
crypto-watcher add 0x1234...abcd --name "main" --chains eth,arb,base

# Configure alerts
crypto-watcher config --gas-alert 20 --balance-change 5%

Commands

# Check all positions
crypto-watcher status

# Check specific wallet
crypto-watcher status main

# Gas prices
crypto-watcher gas

# DeFi positions (via DefiLlama)
crypto-watcher defi 0x1234...abcd

Heartbeat Integration

Add to HEARTBEAT.md:

### Crypto Check
- Run `crypto-watcher status --quiet` 
- Alert if any position health \x3C 1.5 or balance dropped > 10%
- Check gas, alert if \x3C 15 gwei (good time for L1 txs)

Config

~/.config/crypto-watcher/config.json:

{
  "wallets": [
    {
      "address": "0x...",
      "name": "main",
      "chains": ["eth", "arb", "base"]
    }
  ],
  "alerts": {
    "gasThreshold": 20,
    "balanceChangePercent": 5,
    "healthFactorMin": 1.5
  }
}

Data Sources

  • Balances: Public RPCs (no API key needed)
  • DeFi: DefiLlama API (free)
  • Gas: eth_gasPrice RPC call
  • Prices: CoinGecko API (free tier)

Chains Supported

Chain ID RPC
Ethereum eth https://eth.llamarpc.com
Arbitrum arb https://arb1.arbitrum.io/rpc
Base base https://mainnet.base.org
Optimism op https://mainnet.optimism.io
Polygon matic https://polygon-rpc.com
Usage Guidance
This skill appears to do what it says: monitor public wallet addresses and DeFi info. Before installing, consider: (1) the CLI will make outbound network calls to public RPCs and APIs (CoinGecko, DefiLlama) — run it in an environment you trust; (2) it stores watched addresses in ~/.config/crypto-watcher/config.json (no private keys) — do not store private keys or seed phrases there; (3) there is no install spec in the skill metadata, so ensure dependencies (node, compatible node version, and npm-installed dependencies like viem) are available in your runtime; (4) if you need stronger assurance, review or run the code in an isolated environment (container) to observe network behavior. Overall, no unexplained permissions or credential access were found.
Capability Analysis
Type: OpenClaw Skill Name: crypto-watcher Version: 1.0.0 The OpenClaw AgentSkills skill bundle 'crypto-watcher' is classified as benign. The `SKILL.md` instructions are directly aligned with the stated purpose of monitoring crypto wallets and DeFi positions, with no evidence of prompt injection attempts to manipulate the agent for malicious ends. The `src/cli.js` script legitimately interacts with public blockchain RPCs and well-known public APIs (CoinGecko, DefiLlama) to fetch crypto data, and manages its configuration within the user's home directory (`~/.config/crypto-watcher/config.json`). There is no indication of data exfiltration, malicious execution, persistence mechanisms, or obfuscation. All dependencies listed in `package-lock.json` are standard for a web3 application using the `viem` library.
Capability Assessment
Purpose & Capability
Name/intent (wallet and DeFi monitoring) matches required files and behavior: the CLI reads a local config of public wallet addresses, queries public RPC endpoints, CoinGecko, and DefiLlama, and reports balances and gas. The included dependency (viem) is appropriate for Ethereum RPC interactions.
Instruction Scope
Runtime instructions and the SKILL.md align with the implementation. The CLI reads/writes only ~/.config/crypto-watcher/config.json (to store watched addresses), calls public APIs/RPCs, and prints output. It does not request private keys, system tokens, or unrelated files.
Install Mechanism
The package includes source, package.json and package-lock but no explicit install spec in the skill metadata. That is not malicious but means dependencies (viem, etc.) must be installed by the runtime environment before the CLI will run. The dependency sources are standard npm packages (viem and its dependencies) listed in package-lock.json.
Credentials
The skill declares no required environment variables, and the code does not read environment secrets. All external endpoints used are public (CoinGecko, DefiLlama, public RPC URLs). No credentials, tokens, or private keys are requested or stored.
Persistence & Privilege
The skill is not always-enabled and does not modify other skills or system-wide settings. It does persist its own config at ~/.config/crypto-watcher/config.json, which is appropriate for its purpose.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install crypto-watcher
  3. After installation, invoke the skill by name or use /crypto-watcher
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of crypto-watcher. - Track ETH and token balances across multiple chains. - Monitor DeFi positions, LP health, and staking rewards. - Get alerts for low gas prices and large token transfers. - Configure alert thresholds for gas, balance changes, and DeFi position health. - Integrates with heartbeat checks for automated monitoring.
Metadata
Slug crypto-watcher
Version 1.0.0
License
All-time Installs 8
Active Installs 6
Total Versions 1
Frequently Asked Questions

What is Crypto Watcher?

Monitor ETH wallets and DeFi positions across chains with alerts for balance changes, gas prices, health factors, and large token transfers. It is an AI Agent Skill for Claude Code / OpenClaw, with 1132 downloads so far.

How do I install Crypto Watcher?

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

Is Crypto Watcher free?

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

Which platforms does Crypto Watcher support?

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

Who created Crypto Watcher?

It is built and maintained by 0xRaini (@0xraini); the current version is v1.0.0.

💬 Comments