Crypto Price Alerter#

Fetch live cryptocurrency prices and technical indicators via CoinGecko free API.

Quick Usage#

bash

uv run python scripts/price_check.py --symbol BTC --currency USD
uv run python scripts/price_check.py --symbol ETH --currency USD --upper 4000 --lower 2000
uv run python scripts/price_check.py --symbol SOL --currency USD --output json

Core Features#

1. Current Price — Live price, 24h change %, 24h volume, market cap
2. Technical Indicators — SMA(7), SMA(21), RSI(14) from 30-day historical data
3. Key Levels — 30-day resistance and support
4. Price Alerts — Triggered when 24h change >5% or price crosses user thresholds
5. JSON output — For automation pipelines: --output json

Scripts#

• scripts/price_check.py — Main script. Run standalone with uv run python scripts/price_check.py [args]

Arguments#

ArgDescription--symbolCrypto symbol (e.g. BTC, ETH, SOL) — required--currencyFiat currency (default: USD)--upperUpper price threshold for alert--lowerLower price threshold for alert--daysHistorical days for SMA (default: 30)--output``text (default) or json

Technical Signals#

See references/signals.md for explanation of SMA, RSI, support/resistance, and trading signal interpretation.

Alert Logic#

• 24h change > +5% → Bullish alert
• 24h change < -5% → Bearish alert
• Price >= --upper threshold → Price ceiling alert
• Price <= --lower threshold → Price floor alert