Tracking Crypto Prices
Contents
Overview | Prerequisites | Instructions | Output | Error Handling | Examples | Resources
Overview
Foundation skill providing real-time and historical cryptocurrency price data for 10,000+ coins. This is the data layer for the crypto plugin ecosystem -- 10+ other skills depend on it for price information.
Prerequisites
- Install dependencies:
pip install requests pandas yfinance
- Optional:
pip install python-dotenv for API key management
- Optional: Get free API key from https://www.coingecko.com/en/api for higher rate limits
- Add API key to
${CLAUDE_SKILL_DIR}/config/settings.yaml or set COINGECKO_API_KEY env var
Instructions
- Check current prices for one or more symbols:
python ${CLAUDE_SKILL_DIR}/scripts/price_tracker.py --symbol BTC
python ${CLAUDE_SKILL_DIR}/scripts/price_tracker.py --symbols BTC,ETH,SOL
- Use watchlists to scan predefined groups (available:
top10, defi, layer2, stablecoins, memecoins):python ${CLAUDE_SKILL_DIR}/scripts/price_tracker.py --watchlist top10 # Top 10 by market cap
python ${CLAUDE_SKILL_DIR}/scripts/price_tracker.py --watchlist defi # DeFi tokens
python ${CLAUDE_SKILL_DIR}/scripts/price_tracker.py --watchlist layer2 # Layer 2 tokens
- Fetch historical data by period or custom date range:
python ${CLAUDE_SKILL_DIR}/scripts/price_tracker.py --symbol BTC --period 30d
python ${CLAUDE_SKILL_DIR}/scripts/price_tracker.py --symbol BTC --period 90d --output csv
python ${CLAUDE_SKILL_DIR}/scripts/price_tracker.py --symbol ETH --start 2024-01-01 --end 2024-12-31 # 2024 full year
- Configure settings by editing
${CLAUDE_SKILL_DIR}/config/settings.yaml to customize cache TTLs, default currency, and custom watchlists. See references/implementation.md for the full configuration reference.
Output
- Table (default): Symbol, price, 24h change, volume, market cap in formatted columns
- JSON (
--format json): Machine-readable with prices array and metadata
- CSV (
--output csv): OHLCV historical data export to ${CLAUDE_SKILL_DIR}/data/
See ${CLAUDE_SKILL_DIR}/references/implementation.md for detailed output format examples.
Error Handling
| Error |
Cause |
Solution |
Unknown symbol: XYZ |
Invalid ticker |
Check spelling, use --list to search |
Rate limit exceeded |
Too many API calls |
Wait 60s, or add API key for higher limits |
Network error |
No internet |
Check connection; cached data used automatically |
Cache stale |
Data older than TTL |
Shown with warning, refreshes on next call |
The skill auto-manages rate limits: cache first, exponential backoff, yfinance fallback, stale cache as last resort.
Examples
Quick price check:
python ${CLAUDE_SKILL_DIR}/scripts/price_tracker.py --symbol BTC
# Output: BTC (Bitcoin) $97,234.56 USD +2.34% (24h) | Vol: $28.5B | MCap: $1.92T
Watchlist scan:
python ${CLAUDE_SKILL_DIR}/scripts/price_tracker.py --watchlist top10
Historical export:
python ${CLAUDE_SKILL_DIR}/scripts/price_tracker.py --symbol ETH --period 90d --output csv
# Creates: ${CLAUDE_SKILL_DIR}/data/ETH_90d_[date].csv
Resources
${CLAUDE_SKILL_DIR}/references/implementation.md - Output formats, full config, integration guide, file map- CoinGecko API - Primary data source
- yfinance - Fallback for historical data
1---2name: tracking-crypto-prices3description: |4 Track real-time cryptocurrency prices across exchanges with historical data and alerts.5 Provides price data infrastructure for dependent skills (portfolio, tax, DeFi, arbitrage).6 Use when checking crypto prices, monitoring markets, or fetching historical price data.7 Trigger with phrases like "check price", "BTC price", "crypto prices", "price history",8 "get quote for", "what's ETH trading at", "show me top coins", or "track my watchlist".9allowed-tools: Read, Write, Edit, Grep, Glob, Bash(python:*)10version: 2.0.011author: Jeremy Longshore <jeremy@intentsolutions.io>12license: MIT13compatible-with: claude-code, codex, openclaw14tags: [crypto, monitoring, tracking-crypto]1516---1718# Tracking Crypto Prices1920## Contents2122[Overview](#overview) | [Prerequisites](#prerequisites) | [Instructions](#instructions) | [Output](#output) | [Error Handling](#error-handling) | [Examples](#examples) | [Resources](#resources)2324## Overview2526Foundation skill providing real-time and historical cryptocurrency price data for 10,000+ coins. This is the data layer for the crypto plugin ecosystem -- 10+ other skills depend on it for price information.2728## Prerequisites29301. Install dependencies: `pip install requests pandas yfinance`312. Optional: `pip install python-dotenv` for API key management323. Optional: Get free API key from https://www.coingecko.com/en/api for higher rate limits334. Add API key to `${CLAUDE_SKILL_DIR}/config/settings.yaml` or set `COINGECKO_API_KEY` env var3435## Instructions36371. Check current prices for one or more symbols:38 ```bash39 python ${CLAUDE_SKILL_DIR}/scripts/price_tracker.py --symbol BTC40 python ${CLAUDE_SKILL_DIR}/scripts/price_tracker.py --symbols BTC,ETH,SOL41 ```422. Use watchlists to scan predefined groups (available: `top10`, `defi`, `layer2`, `stablecoins`, `memecoins`):43 ```bash44 python ${CLAUDE_SKILL_DIR}/scripts/price_tracker.py --watchlist top10 # Top 10 by market cap45 python ${CLAUDE_SKILL_DIR}/scripts/price_tracker.py --watchlist defi # DeFi tokens46 python ${CLAUDE_SKILL_DIR}/scripts/price_tracker.py --watchlist layer2 # Layer 2 tokens47 ```483. Fetch historical data by period or custom date range:49 ```bash50 python ${CLAUDE_SKILL_DIR}/scripts/price_tracker.py --symbol BTC --period 30d51 python ${CLAUDE_SKILL_DIR}/scripts/price_tracker.py --symbol BTC --period 90d --output csv52 python ${CLAUDE_SKILL_DIR}/scripts/price_tracker.py --symbol ETH --start 2024-01-01 --end 2024-12-31 # 2024 full year53 ```544. Configure settings by editing `${CLAUDE_SKILL_DIR}/config/settings.yaml` to customize cache TTLs, default currency, and custom watchlists. See `references/implementation.md` for the full configuration reference.5556## Output5758- **Table** (default): Symbol, price, 24h change, volume, market cap in formatted columns59- **JSON** (`--format json`): Machine-readable with prices array and metadata60- **CSV** (`--output csv`): OHLCV historical data export to `${CLAUDE_SKILL_DIR}/data/`6162See `${CLAUDE_SKILL_DIR}/references/implementation.md` for detailed output format examples.6364## Error Handling6566| Error | Cause | Solution |67|-------|-------|----------|68| `Unknown symbol: XYZ` | Invalid ticker | Check spelling, use `--list` to search |69| `Rate limit exceeded` | Too many API calls | Wait 60s, or add API key for higher limits |70| `Network error` | No internet | Check connection; cached data used automatically |71| `Cache stale` | Data older than TTL | Shown with warning, refreshes on next call |7273The skill auto-manages rate limits: cache first, exponential backoff, yfinance fallback, stale cache as last resort.7475## Examples7677**Quick price check:**78```bash79python ${CLAUDE_SKILL_DIR}/scripts/price_tracker.py --symbol BTC80# Output: BTC (Bitcoin) $97,234.56 USD +2.34% (24h) | Vol: $28.5B | MCap: $1.92T81```8283**Watchlist scan:**84```bash85python ${CLAUDE_SKILL_DIR}/scripts/price_tracker.py --watchlist top1086```8788**Historical export:**89```bash90python ${CLAUDE_SKILL_DIR}/scripts/price_tracker.py --symbol ETH --period 90d --output csv91# Creates: ${CLAUDE_SKILL_DIR}/data/ETH_90d_[date].csv92```9394## Resources9596- `${CLAUDE_SKILL_DIR}/references/implementation.md` - Output formats, full config, integration guide, file map97- [CoinGecko API](https://www.coingecko.com/en/api) - Primary data source98- [yfinance](https://github.com/ranaroussi/yfinance) - Fallback for historical data99
jeremylongshore