--- name: tracking-crypto-prices-cb2689434a7a description: 'Track real-time cryptocurrency prices across exchanges with historical data and alerts. Provides price data infrastructure for dependent skills (portfolio, tax, DeFi, arbitrage). Use when checking crypto prices, monitoring markets, or fetching historical price data. Trigger with phrases like "check price", "BTC price", "crypto prices", "price history", "get quote for", "what''s ETH trading at", "show me top coins", or "track my watchlist". ' allowed-tools: Read, Write, Edit, Grep, Glob, Bash(python:*) version: 1.28.0 author: Jeremy Longshore license: MIT tags: - crypto - monitoring - tracking-crypto compatibility: Designed for Claude Code --- # Tracking Crypto Prices ## Contents [Overview](#overview) | [Prerequisites](#prerequisites) | [Instructions](#instructions) | [Output](#output) | [Error Handling](#error-handling) | [Examples](#examples) | [Resources](#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 1. Install dependencies: `pip install requests pandas yfinance` 2. Optional: `pip install python-dotenv` for API key management 3. Optional: Get free API key from https://www.coingecko.com/en/api for higher rate limits 4. Add API key to `${CLAUDE_SKILL_DIR}/config/settings.yaml` or set `COINGECKO_API_KEY` env var ## Instructions 1. Check current prices for one or more symbols: ```bash python ${CLAUDE_SKILL_DIR}/scripts/price_tracker.py --symbol BTC python ${CLAUDE_SKILL_DIR}/scripts/price_tracker.py --symbols BTC,ETH,SOL ``` 2. Use watchlists to scan predefined groups (available: `top10`, `defi`, `layer2`, `stablecoins`, `memecoins`): ```bash 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 ``` 3. Fetch historical data by period or custom date range: ```bash 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 ``` 4. 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 [`references/implementation.md`](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:** ```bash 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:** ```bash python ${CLAUDE_SKILL_DIR}/scripts/price_tracker.py --watchlist top10 ``` **Historical export:** ```bash python ${CLAUDE_SKILL_DIR}/scripts/price_tracker.py --symbol ETH --period 90d --output csv # Creates: ${CLAUDE_SKILL_DIR}/data/ETH_90d_[date].csv ``` ## Resources - [`references/implementation.md`](references/implementation.md) - Output formats, full config, integration guide, file map - [CoinGecko API](https://www.coingecko.com/en/api) - Primary data source - [yfinance](https://github.com/ranaroussi/yfinance) - Fallback for historical data --- Source attribution: jeremylongshore Original project: https://github.com/jeremylongshore/claude-code-plugins-plus-skills/blob/ab85a061f7bcc039dac13ee193de7a4cd4388571/plugins/crypto/market-price-tracker/skills/tracking-crypto-prices/SKILL.md License: MIT License information: https://opensource.org/license/mit Original upstream instructions; downloaded from Mega AI Hub. ## Upstream license notice MIT License Copyright (c) 2024-2026 Jeremy Longshore & Contributors Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. # Mega AI Hub resource metadata Creator / publisher: jeremylongshore Original project: https://github.com/jeremylongshore/claude-code-plugins-plus-skills/blob/ab85a061f7bcc039dac13ee193de7a4cd4388571/plugins/crypto/market-price-tracker/skills/tracking-crypto-prices/SKILL.md Attribution basis: Source repository record Fields of work: Data & Analytics, Finance & Accounting, Marketing Roles: Data Analyst, Financial Analyst, Growth Marketer Specialties: API, Backend, Design, Frontend, Git Tools: Pandas, Requests, Yfinance Country applicability: Country not specified Classification basis: Source catalog labels Instruction SHA-256: b9957c7d0fef2abc869859fb0ce881c74229c39aa05af713bae1e7a2380af1b1