🔔

CryptoAlertBot

Never miss a market move.

A production-grade Telegram bot for cryptocurrency price, % change, volume spike, ATH/ATL, and PnL alerts. Set a condition once — the bot watches the market for you around the clock and fires a notification the instant it's met.

Try it on Telegram → View on GitHub
Python 3.12 aiogram 3.13.1 PostgreSQL 16 Redis 7 Docker Compose

What it does

6 alert types

Price threshold, % price change (1h/24h/7d), volume spike, ATH/ATL, daily high/low breakout, PnL entry tracking.

Instant PNG notifications

Each alert fires a rendered price card image straight to Telegram — with automatic text fallback.

Once or repeat

Fire once and auto-deactivate, or keep alerting on every trigger — with configurable cooldown per alert.

Confirm checks

Require N consecutive positive ticks before firing — dramatically reduces false positives on noisy markets.

Reliable pipeline

Redis Streams with consumer groups, auto-restart watchdog, and a circuit breaker — built for 24/7 operation.

Multi-language

English and Ukrainian included today; adding a new language requires only a JSON file.

See it in action

More screenshots on GitHub →

Built for reliability

Async everywhere (aiogram 3, SQLAlchemy async, asyncpg, redis-py async). Stateless condition checkers persist their state in PostgreSQL JSONB, so every restart picks up exactly where it left off. Full architecture, database schema, and Redis key reference are documented in the README, and upcoming work is tracked in the Roadmap.