Alert System

Alert System

The alert system keeps you informed about seu bot’s activity and health sem requiring you to watch the dashboard constantly. Alerts notify you about completed trades, safety events, errors, and performance milestones through Telegram, so voce pode monitor seu bot from anywhere.

Why Alerts Matter

Grid bots are designed to run autonomously, but they operate in a dynamic market environment. Unexpected events, exchange issues, or significant market moves can all require your attention. Without alerts, you would need to check the dashboard regularly to catch these situations.

Alerts let you adopt a hands-off approach while staying informed about events that need your attention. You can go about your day knowing that o bot notify you if something important happens.

Alert Types

Gridera can send notifications for several categories of events:

Trade Alerts

Buy fill: A ordem de compra filled at a nivel de grid. The alert includes the nivel de grid price, tamanho da ordem, and current position count. Useful for tracking how actively o bot is trading.

TP fill: A take-profit order completed. The alert shows the sell price, realized profit for the trade, and updated session PnL. This is the notification that tells you o bot just made money.

Trade summary: A periodic summary (e.g., every 4 hours or daily) showing total trades completed, PnL realizado, and current position count since o ultimo summary. Useful if individual trade alerts are too frequent.

Safety Alerts

Grid break warning: O preco has entered o grid break buffer zone. O bot has not shut down yet, but e close. This gives you a window to decide se to adjust the range or let o bot shut down automatically.

Grid break shutdown: O preco confirmed outside the faixa de grid and o bot is performing a clean shutdown. This alert tells you o bot has stopped and positions are being closed.

Stop loss triggered: The cumulative loss has reached your stop loss threshold. O bot is shutting down para prevenir further losses.

Take profit reached: O bot has reached its profit target. If tp_mode is “stop,” o bot is shutting down. If “continue,” it keeps running.

Health Alerts

Bot started: Confirmation that o bot successfully started and is running its cycle.

Bot stopped: O bot has stopped, either through manual action or an automated shutdown.

Connection error: O bot lost connection to o exchange API or WebSocket feed. It will attempt to reconnect, but persistent errors may require your attention.

Reconciliation correction: The self-healing system detected and corrected a discrepancy. Occasional corrections are normal. Frequent corrections may indicate an underlying issue.

Setting Up Telegram Alerts

To receive alerts via Telegram:

Passo 1: Create a Telegram bot by messaging @BotFather on Telegram. Send the command /newbot, follow the prompts, and save o bot token you receive.

Passo 2: Get your chat ID. Send any message to your new bot, then visit https://api.telegram.org/bot<YOUR_TOKEN>/getUpdates to find your chat ID in the response.

Passo 3: Add the Telegram configuration to seu bot’s settings:

logging:
  telegram_token: "your-bot-token"
  telegram_chat_id: "your-chat-id"

Passo 4: Restart o bot. You should receive a “Bot started” alert confirming the connection works.

Alert Cooldowns

To prevent alert fatigue, the system applies cooldowns to certain alert types. If o preco rebota around a nivel de grid rapidly, voce vai not receive a separate alert for every fill and un-fill.

Trade alerts: No cooldown by default. Each completed trade sends one notification.

Grid break warning: Cooldown of 5 minutes. If o preco dips in and out of the buffer zone rapidly, you receive at most one warning every 5 minutes.

Connection errors: Cooldown of 10 minutes. Brief network hiccups do not flood your messages.

Reconciliation: Cooldown of 15 minutes. Minor corrections are batched rather than sent individually.

These cooldowns are designed to keep you informed sem overwhelming your Telegram with messages during volatile periods.

Customizing Alert Levels

You can adjust which alerts you receive based on your preference:

Minimal: Only safety alerts (grid break, stop loss, errors). Best for experienced traders running stable configurations who only want to know about problems.

Standard: Safety alerts plus TP fills and daily summaries. Good balance of information sem clutter.

Verbose: All alerts including individual buy fills, reconciliation events, and health checks. Best for new bots or configurations voce esta actively tuning.

Melhores Praticas

Do not ignore safety alerts. Grid break warnings and error alerts require attention. Even if you decide not to act, acknowledge that you reviewed the situation.

Mute trade alerts during high activity. If o preco is oscillating rapidly and voce esta getting dozens of TP fill alerts per hour, consider switching to summary mode temporarily.

Test your alert setup. After configuring alerts, start o bot in paper mode and verify you receive notifications. Better to discover a misconfiguration during testing than during a real trading event.

Keep your Telegram bot token secure. Treat it like a password. Do not share it or commit it to version control.

Connect Telegram (Easy Setup)

The simplest way to enable alerts is atraves do Connect Telegram page in the Gridera sidebar:

1. Open Telegram and search for @userinfobot — send /start to get your Chat ID.
2. Search for @Alert_gridera_bot and send it any message.
3. Go to Connect Telegram in Gridera, paste your Chat ID, and click Connect.

You will receive a test message confirming the connection. From then on, all bot notifications are sent directly to your personal Telegram.

What Notifications You Receive

• Bot Start/Stop — know when seu bot starts, stops, or encounters errors.
• Risk Alerts — liquidation warnings, high drawdown, margin alerts.
• Take Profit / Stop Loss — notified when TP or SL triggers.
• Grid Break — alert when price exits sua faixa de grid.
• PnL Milestones — celebrate when you reach $50, $100, $200+ profit.

Resumo

• The alert system sends Telegram notifications for critical bot events so voce pode monitor sem watching the dashboard.
• Use the Connect Telegram page for easy one-click setup.
• Alerts have built-in cooldowns para prevenir notification fatigue.

Proximo Passo

Learn how to diagnose and fix common issues in Solucao de Problemas.