Crypto Price Alerts#

Monitor cryptocurrency prices and get alerts when targets are hit. No API key required — uses CoinGecko's free API.

What It Does#

• Checks current prices for BTC, ETH, SOL, and 100+ coins
• Compares against your configured thresholds
• Alerts when price crosses above/below targets
• Supports percentage moves (e.g., "alert if BTC drops 5% in 1 hour")
• Can run once or on a schedule (cron)

Quick Start#

Check a Single Price#

bash

# Direct API call (no auth needed)
curl "https://api.coingecko.com/api/v3/simple/price?ids=bitcoin,ethereum,solana&vs_currencies=usd&include_24hr_change=true"

Check with More Detail#

bash

curl "https://api.coingecko.com/api/v3/coins/bitcoin?localization=false&tickers=false&community_data=false&developer_data=false&sparkline=false"

Alert Configuration#

Create a crypto-alerts.json file:

json

{
  "alerts": [
    {
      "coin": "bitcoin",
      "symbol": "btc",
      "condition": "below",
      "price": 85000,
      "message": "BTC dropped below $85K!"
    },
    {
      "coin": "bitcoin",
      "symbol": "btc",
      "condition": "above",
      "price": 100000,
      "message": "BTC crossed $100K! 🚀"
    },
    {
      "coin": "ethereum",
      "symbol": "eth",
      "condition": "below",
      "price": 3000,
      "message": "ETH below $3K"
    },
    {
      "coin": "solana",
      "symbol": "sol",
      "condition": "above",
      "price": 200,
      "message": "SOL above $200!"
    }
  ],
  "telegram_bot_token": "YOUR_BOT_TOKEN",
  "telegram_chat_id": "YOUR_CHAT_ID"
}

Python Alert Script#

Save as crypto_alert.py:

python

#!/usr/bin/env python3
import requests
import json
import sys
import os
from datetime import datetime

COINGECKO_API = "https://api.coingecko.com/api/v3"

def get_price(coin_id):
    url = f"{COINGECKO_API}/simple/price"
    params = {
        "ids": coin_id,
        "vs_currencies": "usd",
        "include_24hr_change": "true",
        "include_last_updated_at": "true"
    }
    r = requests.get(url, params=params, timeout=10)
    r.raise_for_status()
    data = r.json()
    return data[coin_id]["usd"], data[coin_id].get("usd_24h_change", 0)

def check_alerts(alerts_config):
    triggered = []
    for alert in alerts_config.get("alerts", []):
        coin = alert["coin"]
        condition = alert["condition"]
        target = alert["price"]
        message = alert["message"]

        try:
            price, change_24h = get_price(coin)
        except Exception as e:
            print(f"Error fetching {coin}: {e}")
            continue

        should_fire = False
        if condition == "above" and price >= target:
            should_fire = True
        elif condition == "below" and price <= target:
            should_fire = True

        if should_fire:
            triggered.append({
                "coin": coin,
                "price": price,
                "target": target,
                "condition": condition,
                "message": message,
                "change_24h": change_24h,
                "time": datetime.now().isoformat()
            })
            print(f"🚨 ALERT: {message} (Current: ${price:,.2f})")
        else:
            print(f"  {coin.upper()}: ${price:,.2f} (24h: {change_24h:+.2f}%) — {condition} ${target:,.2f}: {'✓' if should_fire else 'not triggered'}")

    return triggered

def send_telegram(message, bot_token, chat_id):
    if not bot_token or not chat_id:
        return
    url = f"https://api.telegram.org/bot{bot_token}/sendMessage"
    payload = {"chat_id": chat_id, "text": message, "parse_mode": "HTML"}
    requests.post(url, json=payload, timeout=10)

if __name__ == "__main__":
    config_path = os.path.join(os.path.dirname(__file__), "crypto-alerts.json")

    if len(sys.argv) > 1:
        config_path = sys.argv[1]

    if os.path.exists(config_path):
        with open(config_path) as f:
            config = json.load(f)
    else:
        print("No crypto-alerts.json found. Using default BTC/ETH/SOL check.")
        config = {
            "alerts": [
                {"coin": "bitcoin", "symbol": "btc", "condition": "above", "price": 0},
                {"coin": "ethereum", "symbol": "eth", "condition": "above", "price": 0},
                {"coin": "solana", "symbol": "sol", "condition": "above", "price": 0}
            ]
        }

    triggered = check_alerts(config)

    if triggered:
        summary = "🚨 <b>Crypto Alert Triggered</b>\n\n"
        for t in triggered:
            summary += f"{t['message']}\n"
            summary += f"Price: ${t['price']:,.2f} | 24h: {t['change_24h']:+.2f}%\n\n"

        bot_token = config.get("telegram_bot_token")
        chat_id = config.get("telegram_chat_id")
        if bot_token and chat_id:
            send_telegram(summary, bot_token, chat_id)

        with open("/tmp/crypto_alerts_triggered.json", "a") as f:
            f.write(json.dumps({"triggered": triggered, "time": datetime.now().isoformat()}) + "\n")

Usage Examples#

Run Once#

bash

python3 crypto_alert.py

Run on Schedule (Cron)#

bash

# Every 15 minutes
*/15 * * * * cd /path/to/skill && python3 crypto_alert.py >> /tmp/crypto_alerts.log 2>&1

# Every hour at minute 0
0 * * * * cd /path/to/skill && python3 crypto_alert.py >> /tmp/crypto_alerts.log 2>&1

Check Specific Coin#

bash

# Bitcoin
curl "https://api.coingecko.com/api/v3/simple/price?ids=bitcoin&vs_currencies=usd&include_24hr_change=true"

# Multiple coins
curl "https://api.coingecko.com/api/v3/simple/price?ids=bitcoin,ethereum,solana,cardano,polkadot,avalanche-2,chainlink&vs_currencies=usd&include_24hr_change=true"

Supported Coins (Common IDs)#

SymbolCoinGecko IDBTCbitcoinETHethereumSOLsolanaADAcardanoDOTpolkadotAVAXavalanche-2LINKchainlinkXRPrippleDOGEdogecoinMATICpolygonARBarbitrumOPoptimism

For full list: curl https://api.coingecko.com/api/v3/coins/list?per_page=250

Alert Conditions#

• above — Fire when price >= target
• below — Fire when price <= target
• percent_up — Fire when 24h change > X% (add percent_threshold field)
• percent_down — Fire when 24h change < -X% (add percent_threshold field)

Rate Limits#

CoinGecko free API:

• ~10-30 calls/minute
• 10,000-50,000 calls/month
• Use caching if checking frequently
• Add sleep(1.2) between calls to be safe

Requirements#

• requests Python library ( pip install requests)
• CoinGecko API (free, no key needed)
• Optional: Telegram bot for push notifications
• Optional: cron for scheduled monitoring

Tips#

1. Don't spam checks — 15-minute intervals are fine for most use cases
2. Cache prices — Store last check to avoid redundant API calls
3. Multiple conditions — One coin can have multiple alerts (above AND below)
4. Logging — Always log to a file so you can review what fired

---

Based on real crypto monitoring work. CoinGecko API is free but respectful usage is expected.