Search v1.0.0

Crypto Tracker

πŸ‘€
@dbhurley

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

Installation

openclaw skill add dbhurley/crypto-tracker

Technical Specification

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