How to Build a Telegram Trading Alert Bot in 30 Minutes

import requests

TELEGRAM_TOKEN = "your_bot_token"
TELEGRAM_CHAT_ID = "your_chat_id"

def send_alert(message: str):
    """Send a message via Telegram."""
    url = f"https://api.telegram.org/bot{TELEGRAM_TOKEN}/sendMessage"
    resp = requests.post(url, json={
        "chat_id": TELEGRAM_CHAT_ID,
        "text": message,
        "parse_mode": "Markdown"
    })
    if resp.status_code != 200:
        print(f"Telegram error: {resp.text}")

CLAW_API_KEY = "your_tickatlas_api_key"
CLAW_BASE = "https://tickatlas.com/v1"
CLAW_HEADERS = {"X-API-Key": CLAW_API_KEY}

WATCHLIST = ["EURUSD", "GBPUSD", "USDJPY", "XAUUSD", "BTCUSD"]

def scan_for_signals() -> list[dict]:
    """Scan all watchlist symbols for trading signals."""
    signals = []

    for symbol in WATCHLIST:
        resp = requests.get(f"{CLAW_BASE}/indicators", params={
            "symbol": symbol,
            "timeframe": "H1",
            "indicators": "RSI_14,MACD,BBANDS_20"
        }, headers=CLAW_HEADERS)

        if resp.status_code != 200:
            continue

        data = resp.json()["data"]
        ind = data["indicators"]
        price = data.get("price", {}).get("close", 0)

        rsi = ind["RSI_14"]["value"]
        macd_hist = ind["MACD"]["histogram"]
        bb = ind["BBANDS_20"]

        # Check for buy signals
        if rsi < 30 and macd_hist > 0:
            signals.append({
                "symbol": symbol,
                "direction": "BUY",
                "reason": f"RSI oversold ({rsi:.1f}) + MACD bullish",
                "price": price,
                "rsi": rsi
            })
        elif price <= bb["lower"] * 1.002 and rsi < 35:
            signals.append({
                "symbol": symbol,
                "direction": "BUY",
                "reason": f"Bollinger lower band touch + RSI {rsi:.1f}",
                "price": price,
                "rsi": rsi
            })

        # Check for sell signals
        if rsi > 70 and macd_hist < 0:
            signals.append({
                "symbol": symbol,
                "direction": "SELL",
                "reason": f"RSI overbought ({rsi:.1f}) + MACD bearish",
                "price": price,
                "rsi": rsi
            })
        elif price >= bb["upper"] * 0.998 and rsi > 65:
            signals.append({
                "symbol": symbol,
                "direction": "SELL",
                "reason": f"Bollinger upper band touch + RSI {rsi:.1f}",
                "price": price,
                "rsi": rsi
            })

    return signals

from datetime import datetime

def format_alert(signal: dict) -> str:
    """Format signal as a Telegram message."""
    emoji = "🟢" if signal["direction"] == "BUY" else "🔴"
    return (
        f"{emoji} *{signal['direction']} Alert: {signal['symbol']}*\n"
        f"Reason: {signal['reason']}\n"
        f"Price: {signal['price']}\n"
        f"RSI: {signal['rsi']:.1f}\n"
        f"Time: {datetime.utcnow().strftime('%Y-%m-%d %H:%M')} UTC"
    )

import time

def run_alert_bot():
    """Main loop — scans market and sends alerts."""
    print(f"Alert bot started. Watching: {', '.join(WATCHLIST)}")
    sent_signals = set()  # Avoid duplicate alerts

    while True:
        try:
            signals = scan_for_signals()

            for signal in signals:
                # Create unique key to prevent duplicate alerts
                key = f"{signal['symbol']}_{signal['direction']}_{datetime.utcnow().hour}"

                if key not in sent_signals:
                    message = format_alert(signal)
                    send_alert(message)
                    sent_signals.add(key)
                    print(f"Alert sent: {signal['symbol']} {signal['direction']}")

            # Clean old keys every hour
            if datetime.utcnow().minute == 0:
                sent_signals.clear()

        except Exception as e:
            print(f"Error: {e}")

        time.sleep(300)  # Check every 5 minutes

if __name__ == "__main__":
    run_alert_bot()