CoinGecko Price Skill

Fetch real-time crypto prices, 24h changes, market cap, and volume from CoinGecko's free API. Zero dependencies — native Node.js fetch only.

Usage

Get Price by Token ID

node scripts/price.mjs --token ethereum
node scripts/price.mjs --token bitcoin
node scripts/price.mjs --token solana

Get Price by Contract Address

# Token on Base
node scripts/price.mjs --contract 0xf3Ce5dDAAb6C133F9875a4a46C55cf0b58111B07 --chain base

# Token on Ethereum
node scripts/price.mjs --contract 0xdAC17F958D2ee523a2206206994597C13D831ec7 --chain ethereum

# Token on Polygon
node scripts/price.mjs --contract 0x... --chain polygon-pos

Watch Price with Alerts

# Monitor ETH every 5 minutes, alert on thresholds
node scripts/watch.mjs --token ethereum --interval 300 --alert-above 4000 --alert-below 3000

# Monitor BTC every 60 seconds
node scripts/watch.mjs --token bitcoin --interval 60 --alert-above 100000 --alert-below 90000

Output Format

ethereum (ETH)
  Price:      $3,456.78
  24h Change: +2.34%
  Market Cap: $415.2B
  24h Volume: $12.8B

API Details

• Base URL: https://api.coingecko.com/api/v3
• Auth: None required (free tier)
• Rate Limit: ~30 requests/minute
• Platform IDs: base, ethereum, polygon-pos, solana, arbitrum-one

Requirements

• Node.js 18+ (native fetch)
• No dependencies