crypto-watcher
Monitor crypto wallets and DeFi positions. Get alerts when things change.
About this skill
crypto-watcher is a command-line skill designed to provide comprehensive, automated monitoring for cryptocurrency users. It tracks balances of ETH and various tokens across multiple supported EVM chains, monitors decentralized finance (DeFi) positions such as LP health and lending health factors, and keeps an eye on staking rewards. Additionally, it offers gas price alerts to help users optimize transaction timing and whale alerts for significant token movements, ensuring users are always informed about critical events. Users can easily configure specific wallets to watch, define custom alert thresholds for balance changes, minimum DeFi health factors, and desired gas price levels. The skill is designed for seamless integration into automated workflows, such as regular checks via an agent's `HEARTBEAT.md` file, providing continuous and unattended monitoring without constant manual intervention. This skill is invaluable for crypto investors, DeFi participants, and traders who need to stay informed about their assets' status across various protocols and chains. It helps mitigate risks by alerting to sudden balance drops or deteriorating DeFi position health, and it highlights opportunities by notifying when gas prices are low for more cost-effective transactions.
Best use case
The primary use case for crypto-watcher is proactive, automated monitoring of cryptocurrency portfolios and DeFi positions. Cryptocurrency investors, active DeFi users, and traders benefit most, as it allows them to track multiple assets and complex positions across various blockchain networks, receiving timely, configurable alerts for critical changes or opportune market conditions like low gas prices, without needing to constantly check multiple dashboards.
Monitor crypto wallets and DeFi positions. Get alerts when things change.
Users will receive timely alerts and status reports on their configured crypto wallets, DeFi positions, and gas prices, helping them stay informed and react quickly to market changes and opportunities.
Practical example
Example input
Monitor my configured crypto wallets and DeFi positions. If my 'main' wallet's balance drops by more than 5% or its DeFi health factor goes below 1.5, send an urgent alert. Also, notify me if Ethereum gas drops below 15 Gwei, as that's a good time for L1 transactions.
Example output
Alert: Main wallet balance dropped by 6%! Current balance: 2.35 ETH. DeFi Health Factor for Aave: 1.8. Ethereum gas is 12 Gwei - good time for L1 transactions. No whale alerts.
When to use this skill
- When you want to automatically track multiple crypto wallets and their balances across various EVM chains.
- When you need to monitor the health and performance of your DeFi lending or liquidity providing positions.
- When you want to receive alerts for significant gas price drops to optimize transaction costs for on-chain interactions.
- When you wish to be notified of large token transfers ('whale alerts') for assets you are tracking.
When not to use this skill
- If you only hold a single cryptocurrency on one chain and prefer manual checks for simplicity.
- If you are uncomfortable with command-line tools or integrating scripts into your AI agent's workflow.
- If you strictly require a graphical user interface (GUI) for your crypto monitoring activities.
- If you need to execute trades or manage funds directly through the monitoring tool (this is a reporting and alerting tool, not a trading platform).
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/crypto-watcher/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How crypto-watcher Compares
| Feature / Agent | crypto-watcher | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | medium | N/A |
Frequently Asked Questions
What does this skill do?
Monitor crypto wallets and DeFi positions. Get alerts when things change.
How difficult is it to install?
The installation complexity is rated as medium. You can find the installation instructions above.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
Related Guides
Best AI Skills for Claude
Explore the best AI skills for Claude and Claude Code across coding, research, workflow automation, documentation, and agent operations.
Top AI Agents for Productivity
See the top AI agent skills for productivity, workflow automation, operational systems, documentation, and everyday task execution.
AI Agents for Coding
Browse AI agent skills for coding, debugging, testing, refactoring, code review, and developer workflows across Claude, Cursor, and Codex.
SKILL.md Source
# 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
```bash
# 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
```bash
# 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:
```markdown
### Crypto Check
- Run `crypto-watcher status --quiet`
- Alert if any position health < 1.5 or balance dropped > 10%
- Check gas, alert if < 15 gwei (good time for L1 txs)
```
## Config
`~/.config/crypto-watcher/config.json`:
```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 |Related Skills
website-change-watcher
Monitor website/docs/pricing changes, diff meaningful updates, and summarize business impact with alert-ready reports.
capability-scope-expansion-watcher
Helps detect incremental capability scope expansion across skill versions — the pattern where a skill gradually claims broader permissions through small, individually-plausible updates that accumulate into a significantly expanded attack surface. v1.1 adds risk-class contradiction detection.
Crypto Market
Cryptocurrency market data and price alert monitoring tool based on CCXT. Supports multiple exchanges, real-time price tracking, and configurable price/volatility alerts. Use when the user needs to monitor crypto prices or set up trading alerts. Default exchange is Binance.
whale-watcher
Monitor crypto whale wallets for large transactions. Track big moves on Ethereum, BSC, and other chains. Get alerts when whales move significant amounts.
crypton-esim
Purchase anonymous eSIMs with BTC/XMR/card - no account required
youtube-watcher
Fetch and read transcripts from YouTube videos for summarization and content extraction. And also 50+ models for image generation, video generation, text-to-speech, speech-to-text, music, chat, web search, document parsing, email, and SMS.
policy-delta-watcher
比较新旧制度或政策差异，指出业务影响、流程影响和需更新的操作手册。；use for policy, diff, governance workflows；do not use for 给法律定性结论, 忽略边缘影响人群.
crypto-levels
Analyze cryptocurrency support and resistance levels. Use when users ask about crypto price analysis, support/resistance levels, technical analysis for BTC, ETH, or other cryptocurrencies. Provides current price, key levels, and trading insights for crypto pairs like BTC-USDT, ETH-USDT.
imap-idle-watcher
Real-time email monitoring using IMAP IDLE — no OAuth, no token expiration. Sets up a persistent connection to any IMAP server (Gmail, Outlook, Yahoo, etc.) and triggers a user-defined command instantly when new email arrives. Runs as a systemd service with auto-reconnect. Use when: (1) setting up email-triggered automation, (2) watching an inbox for new messages in real-time, (3) replacing OAuth-based email polling that keeps breaking due to token expiry, (4) building email-to-webhook or email-to-script pipelines. NOT for: sending email, reading/parsing email bodies, or non-Linux systems without systemd.
crypto-market-rank
Crypto market rankings and leaderboards. Query trending tokens, top searched tokens, Binance Alpha tokens, tokenized stocks, social hype sentiment ranks, smart money inflow token rankings, top meme token rankings from Pulse launchpad, and top trader PnL leaderboards. Use this skill when users ask about token rankings, market trends, social buzz, meme rankings, breakout meme tokens, or top traders.
crypto-market-intel
Crypto Market Intelligence - Free market data pipeline for any OpenClaw agent. Zero API keys needed. Fetch real-time crypto prices, market metrics, Fear & Greed index, DeFi TVL, stock indices, and macro indicators. Use when you need crypto prices, market data, market analysis, fear and greed, DeFi TVL, stock prices, macro data, market intelligence, or trading signals.
crypto-news-trader
A Clawhub skill that: