DEV Community

neuralmint
neuralmint

Posted on

Crypto Price Alert CLI — Monitor Prices and Trigger Alerts From Your Terminal

#python #crypto #cli #opensource

Ever wanted to get pinged when Bitcoin hits $100K or Ethereum drops below $1,500 — without installing a bloated exchange app or signing up for yet another notification service?

Meet crypto-price-alert, a zero-dependency CLI tool that checks CoinGecko prices and fires alerts when your thresholds are crossed.

Features

  • check — One-off price query for any CoinGecko-listed coin
  • watch — Continuous monitoring with above/below alert triggers
  • alerts — Add, list, and remove alert configurations
  • --json — Machine-parseable JSON output for scripting
  • Webhooks — POST alert notifications to any webhook URL
  • Pure Python stdlib — no pip install, no API keys, no bloat

Quick Demo 

# Check Bitcoin price
python3 crypto_price_alert.py check bitcoin
# → [14:32:01 UTC] Bitcoin: $75,593.15 (-1.55%)

# Check Ethereum in EUR as JSON
python3 crypto_price_alert.py --json check ethereum --currency eur
# → {"coin": "ethereum", "currency": "eur", "price": 1782.27, "change_24h": -1.19}
Enter fullscreen mode Exit fullscreen mode

Set Up Alerts 

# Alert when BTC crosses $100K
python3 crypto_price_alert.py alerts add bitcoin --above 100000

# Alert when ETH drops below $1,500
python3 crypto_price_alert.py alerts add ethereum --below 1500

# List your alerts
python3 crypto_price_alert.py alerts list
Enter fullscreen mode Exit fullscreen mode

Run the Watcher 

python3 crypto_price_alert.py watch --interval 60
Enter fullscreen mode Exit fullscreen mode

It'll poll CoinGecko every 60 seconds and print an alert line when a threshold is crossed. Add --webhook to your alerts for HTTP POST notifications to Slack, Discord, or any custom endpoint.

Tech Stack

  • CoinGecko API — free, no API key required
  • Python stdlib only — urllib, json, argparse, time, datetime
  • MIT licensed — use it anywhere, modify freely

Install

No pip needed. Just grab the single file:

curl -L https://raw.githubusercontent.com/neuralmint/crypto-price-alert/main/crypto_price_alert.py -o crypto_price_alert.py
python3 crypto_price_alert.py --help
Enter fullscreen mode Exit fullscreen mode

Or clone the repo:

git clone https://github.com/neuralmint/crypto-price-alert.git
cd crypto-price-alert
python3 crypto_price_alert.py check bitcoin
Enter fullscreen mode Exit fullscreen mode

Why I Built This

I was tired of context-switching to check prices during development. Most crypto tracking tools require browser tabs, mobile notifications, or bloated desktop apps. I wanted something that lives in the terminal, consumes no RAM when idle, and integrates with my existing workflow (webhooks → Slack/Discord/Telegram).

Plus, it was a good excuse to prove that useful crypto tooling can be built with nothing but the Python standard library.

Support

If this tool saves you time or money, feel free to toss a coin:

  • SOL: 4TGyiYBjaYhFFPNYyCoJjf16ctUsWVBiMR1FXQxEfhWi
  • ETH: 0xe07f177E0725c11EEc8BeA34C5b5193CaF2a1A6a

Built with Python stdlib. Powered by CoinGecko. MIT licensed.

Top comments (0)