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
Converted and distributed by TomeVault — claim your Tome and manage your conversions.
1---2name: jeremylongshore-claude-code-plugins-plus-skills-tracking-cry3description: Tracking Crypto Prices4---5# Tracking Crypto Prices67## Contents89[Overview](#overview) | [Prerequisites](#prerequisites) | [Instructions](#instructions) | [Output](#output) | [Error Handling](#error-handling) | [Examples](#examples) | [Resources](#resources)1011## Overview1213Foundation 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.1415## Prerequisites16171. Install dependencies: `pip install requests pandas yfinance`182. Optional: `pip install python-dotenv` for API key management193. Optional: Get free API key from https://www.coingecko.com/en/api for higher rate limits204. Add API key to `${CLAUDE_SKILL_DIR}/config/settings.yaml` or set `COINGECKO_API_KEY` env var2122## Instructions23241. Check current prices for one or more symbols:25 ```bash26 python ${CLAUDE_SKILL_DIR}/scripts/price_tracker.py --symbol BTC27 python ${CLAUDE_SKILL_DIR}/scripts/price_tracker.py --symbols BTC,ETH,SOL28 ```292. Use watchlists to scan predefined groups (available: `top10`, `defi`, `layer2`, `stablecoins`, `memecoins`):30 ```bash31 python ${CLAUDE_SKILL_DIR}/scripts/price_tracker.py --watchlist top10 # Top 10 by market cap32 python ${CLAUDE_SKILL_DIR}/scripts/price_tracker.py --watchlist defi # DeFi tokens33 python ${CLAUDE_SKILL_DIR}/scripts/price_tracker.py --watchlist layer2 # Layer 2 tokens34 ```353. Fetch historical data by period or custom date range:36 ```bash37 python ${CLAUDE_SKILL_DIR}/scripts/price_tracker.py --symbol BTC --period 30d38 python ${CLAUDE_SKILL_DIR}/scripts/price_tracker.py --symbol BTC --period 90d --output csv39 python ${CLAUDE_SKILL_DIR}/scripts/price_tracker.py --symbol ETH --start 2024-01-01 --end 2024-12-31 # 2024 full year40 ```414. 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.4243## Output4445- **Table** (default): Symbol, price, 24h change, volume, market cap in formatted columns46- **JSON** (`--format json`): Machine-readable with prices array and metadata47- **CSV** (`--output csv`): OHLCV historical data export to `${CLAUDE_SKILL_DIR}/data/`4849See `${CLAUDE_SKILL_DIR}/references/implementation.md` for detailed output format examples.5051## Error Handling5253| Error | Cause | Solution |54|-------|-------|----------|55| `Unknown symbol: XYZ` | Invalid ticker | Check spelling, use `--list` to search |56| `Rate limit exceeded` | Too many API calls | Wait 60s, or add API key for higher limits |57| `Network error` | No internet | Check connection; cached data used automatically |58| `Cache stale` | Data older than TTL | Shown with warning, refreshes on next call |5960The skill auto-manages rate limits: cache first, exponential backoff, yfinance fallback, stale cache as last resort.6162## Examples6364**Quick price check:**65```bash66python ${CLAUDE_SKILL_DIR}/scripts/price_tracker.py --symbol BTC67# Output: BTC (Bitcoin) $97,234.56 USD +2.34% (24h) | Vol: $28.5B | MCap: $1.92T68```6970**Watchlist scan:**71```bash72python ${CLAUDE_SKILL_DIR}/scripts/price_tracker.py --watchlist top1073```7475**Historical export:**76```bash77python ${CLAUDE_SKILL_DIR}/scripts/price_tracker.py --symbol ETH --period 90d --output csv78# Creates: ${CLAUDE_SKILL_DIR}/data/ETH_90d_[date].csv79```8081## Resources8283- `${CLAUDE_SKILL_DIR}/references/implementation.md` - Output formats, full config, integration guide, file map84- [CoinGecko API](https://www.coingecko.com/en/api) - Primary data source85- [yfinance](https://github.com/ranaroussi/yfinance) - Fallback for historical data8687---88> Converted and distributed by [TomeVault](https://tomevault.io/claim/jeremylongshore) — claim your Tome and manage your conversions.89<!-- tomevault:4.0:skill_md:2026-04-11 -->
tomevault-io