Telegram Bot

Configure signal notifications via Telegram bot

Bot Status

Webhook URL

Set this URL in Telegram so bot commands (/subscribe, /signals, etc.) are delivered to your server.

Your Webhook Endpoint

Run this curl command to register the webhook:

curl -X POST "https://api.telegram.org/bot$TELEGRAM_BOT_TOKEN/setWebhook" \
  -H "Content-Type: application/json" \
  -d '{"url":""}'

Test Message

Send a test message to verify your bot is working. Find your chat ID by messaging @userinfobot on Telegram.

Channel Auto-Broadcast

Automatically post top signals to a Telegram channel every 4 hours. Set TELEGRAM_CHANNEL_ID in your .env or override below.

Channel ID Override

Message Preview

📡 TradeClaw Signal Broadcast ━━━━━━━━━━━━━━━━━━━━ 🟢 BUY XAUUSD | 87% confidence 💰 Entry: $2,345.50 🎯 TP: $2,360.00 / $2,374.50 / $2,389.00 🛑 SL: $2,331.00 📊 RSI 32.4 | MACD ✅ 🔴 SELL EURUSD | 79% confidence 💰 Entry: $1.1559 🎯 TP: $1.1520 / $1.1490 / $1.1460 🛑 SL: $1.1595 📊 RSI 71.2 | MACD ⚠️ ━━━━━━━━━━━━━━━━━━━━ 🤖 TradeClaw | github.com/naimkatiman/tradeclaw ⚠️ Not financial advice. DYOR.

Bot Commands Reference

/startWelcome message + auto-subscribe

/subscribeSubscribe to signal alerts

/unsubscribeStop receiving alerts

/signalsGet latest signals on demand

/pairsList available trading pairs

/settingsView subscription settings

/helpShow all commands

API Endpoints

POST

/api/telegram/webhook

Telegram webhook receiver — register this URL with BotFather

POST

/api/telegram/send

Manually trigger a signal send (supports broadcast to all subscribers)

GET

/api/telegram/status

Bot connection status, webhook info, and subscriber count

POST

/api/telegram/broadcast

Trigger a channel broadcast of top 3 signals

GET

/api/telegram/broadcast

Broadcast status — last time, next time, count

GET

/api/cron/telegram

Vercel cron endpoint — auto-broadcasts every 4 hours