Crypto Price Alerter

Monitor live cryptocurrency prices, technical indicators, and support/resistance levels with customizable price alerts and portfolio summaries.

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

Quick Usage

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

Arg	Description
--symbol	Crypto symbol (e.g. BTC, ETH, SOL) — required
--currency	Fiat currency (default: USD)
--upper	Upper price threshold for alert
--lower	Lower price threshold for alert
--days	Historical 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