crypto-tracker
Track crypto prices, set alerts, and search coins via CoinGecko API.
When & Why to Use This Skill
This Claude skill provides a comprehensive cryptocurrency tracking and alerting system powered by the CoinGecko API. It enables users to monitor real-time prices, search for thousands of digital assets, and configure automated alerts for price thresholds or percentage changes, streamlining crypto market oversight directly within the AI environment without requiring an API key.
Use Cases
- Real-time Price Monitoring: Instantly retrieve live prices, market capitalization, and trading volume for Bitcoin, Ethereum, and over 15,000 other coins using simple commands or aliases.
- Automated Threshold Alerts: Configure 'above' or 'below' price triggers to receive notifications when an asset reaches a specific valuation, helping users execute timely investment or divestment strategies.
- Volatility Tracking: Set percentage-based alerts (e.g., ±10% change in 24h) to stay informed about sudden market movements and high-volatility events across a diverse portfolio.
- Scheduled Market Reporting: Integrate with cron jobs to periodically check alerts and generate machine-readable JSON outputs for automated portfolio monitoring and data logging.
| name | crypto-tracker |
|---|---|
| description | Track crypto prices, set alerts, and search coins via CoinGecko API. |
| homepage | https://www.coingecko.com/api |
| metadata | {"clawdis":{"emoji":"📈","requires":{"bins":["uv"]}}} |
Crypto Tracker
Track cryptocurrency prices, set price/percentage alerts, and search coins using the free CoinGecko API (no API key required).
Quick Commands
Check Prices
# Single coin
uv run {baseDir}/scripts/crypto.py price bitcoin
# Multiple coins
uv run {baseDir}/scripts/crypto.py price bitcoin ethereum solana
# With more details (market cap, volume)
uv run {baseDir}/scripts/crypto.py price bitcoin --detailed
Search Coins
# Find coin ID by name/symbol
uv run {baseDir}/scripts/crypto.py search doge
uv run {baseDir}/scripts/crypto.py search cardano
Manage Alerts
# Set price threshold alert
uv run {baseDir}/scripts/crypto.py alert <user_id> bitcoin above 100000
uv run {baseDir}/scripts/crypto.py alert <user_id> ethereum below 3000
# Set percentage change alert (24h)
uv run {baseDir}/scripts/crypto.py alert <user_id> bitcoin change 5 # ±5%
uv run {baseDir}/scripts/crypto.py alert <user_id> solana drop 10 # -10%
uv run {baseDir}/scripts/crypto.py alert <user_id> ethereum rise 15 # +15%
# List user's alerts
uv run {baseDir}/scripts/crypto.py alerts <user_id>
# Remove an alert
uv run {baseDir}/scripts/crypto.py alert-rm <alert_id>
# Check all alerts (for cron/heartbeat)
uv run {baseDir}/scripts/crypto.py check-alerts
Coin Aliases
Common symbols are automatically resolved:
btc→ bitcoineth→ ethereumsol→ solanadoge→ dogecoinada→ cardanoxrp→ rippledot→ polkadotmatic→ polygonlink→ chainlinkavax→ avalanche-2ltc→ litecoin
Alert Types
| Type | Example | Triggers When |
|---|---|---|
above |
alert user btc above 100000 |
Price >= $100,000 |
below |
alert user eth below 3000 |
Price <= $3,000 |
change |
alert user btc change 5 |
24h change >= ±5% |
drop |
alert user sol drop 10 |
24h change <= -10% |
rise |
alert user eth rise 15 |
24h change >= +15% |
Cron Integration
Check alerts periodically (e.g., every 15 minutes):
uv run {baseDir}/scripts/crypto.py check-alerts --json-output
Returns triggered alerts with user IDs for notification.
Data Storage
Alerts stored in {baseDir}/data/alerts.json with:
- Per-user alert tracking
- Cooldown between repeat notifications (default: 1 hour)
- Last triggered timestamp
Notes
- CoinGecko free tier: ~10-30 requests/minute (no API key needed)
- 15,000+ coins supported
- Use
--json-outputflag for machine-readable output