mcpField
C
crypto-tracker

crypto-tracker

github.com/sundial-orgOther670136 installsUpdated 34w ago
Repository

About crypto-tracker

Crypto Tracker is a command-line skill for checking cryptocurrency prices and managing price or percentage-change alerts with the CoinGecko API. It also searches coins and stores per-user alerts for periodic checks.

Key features

  1. 01Check prices for one or more coins
  2. 02View market cap and volume details
  3. 03Search coins by name or symbol
  4. 04Set price and percentage-change alerts
  5. 05Check alerts for notifications

Use cases

  1. 01Check current prices for selected coins
  2. 02Find a coin using its name or ticker
  3. 03Set thresholds for price movements
  4. 04Run periodic checks for triggered alerts

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/sundial-org/awesome-openclaw-skills --skill crypto-tracker

After installing, type/crypto-trackerin Claude Code to confirm it loaded.

Bundled filesdata/alerts.jsonscripts/crypto.py

Details

From the project README

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

TypeExampleTriggers When
abovealert user btc above 100000Price >= $100,000
belowalert user eth below 3000Price <= $3,000
changealert user btc change 524h change >= ±5%
dropalert user sol drop 1024h change <= -10%
risealert user eth rise 1524h 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

Comments

Markdown supported