crypto-tracker

Track crypto prices, set alerts, and search coins via CoinGecko API.

⭐2stars🔀0forks📁View on GitHub🕐Updated Jan 8, 2026⬇️1downloads

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.
namecrypto-tracker
descriptionTrack crypto prices, set alerts, and search coins via CoinGecko API.
homepagehttps://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 → bitcoin
  • eth → ethereum
  • sol → solana
  • doge → dogecoin
  • ada → cardano
  • xrp → ripple
  • dot → polkadot
  • matic → polygon
  • link → chainlink
  • avax → avalanche-2
  • ltc → 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-output flag for machine-readable output