Notifications
Alert Types Reference
A complete reference of every notification event TradingForge can send, including what triggers each alert and what information it contains.
TradingForge can notify you about events across four categories: trade lifecycle events, engine state changes, balance conditions, and system connectivity. Each alert type can be individually enabled or disabled in Settings → Notifications. The table below is a complete reference of every available alert.
Alerts are delivered to whichever channels you have configured — Telegram, email, or both. You can enable a channel globally and then selectively disable individual alert types you don't need.
Trade Events
| Alert Type | Category | Default Enabled | Description |
|---|---|---|---|
| Trade Opened | Trade | Yes | A new base order was placed on the exchange. Notification includes the trading pair, entry price, and base order size. |
| Safety Order Triggered | Trade | Yes | A safety order was filled. Notification includes the SO number, fill price, updated average entry price, and total position size. |
| Take Profit Hit | Trade | Yes | Position was closed at the take profit target. Notification includes the trading pair, realized profit amount, profit percentage, and how long the trade was held. |
| Trade Closed (Manual) | Trade | Yes | A position was manually closed from the dashboard. Notification includes the trading pair and realized P&L (which may be a loss if closed before TP). |
| Max Safety Orders Reached | Trade | Yes | All configured safety orders have been exhausted. The position is still open but no further averaging down will occur. This may indicate a stuck trade that needs attention. |
Engine Events
| Alert Type | Category | Default Enabled | Description |
|---|---|---|---|
| Engine Started | Engine | Yes | The TradeFuel or TradeSmith engine was started. Notification confirms which engine started and the timestamp. |
| Engine Stopped | Engine | Yes | The engine was stopped, either manually from the dashboard or due to an error. Notification includes the stop reason. |
| Engine Error | Engine | Yes | A critical error occurred in the trading engine that caused it to halt. Notification includes the full error message to help diagnose the cause. |
Balance Events
| Alert Type | Category | Default Enabled | Description |
|---|---|---|---|
| Insufficient Balance | Balance | Yes | TradingForge attempted to place a safety order but your free balance on the exchange was not sufficient to cover it. The order was skipped. Add funds or reduce order sizes. |
| Low Balance Alert | Balance | No | Your total account balance has fallen below a threshold you configure. This is a proactive warning before insufficient balance errors begin occurring. |
System Events
| Alert Type | Category | Default Enabled | Description |
|---|---|---|---|
| Connection Lost | System | Yes | TradingForge lost its connection to the exchange API. No orders can be placed or monitored while disconnected. Check your internet connection and the exchange status page. |
| Connection Restored | System | Yes | The exchange API connection has been re-established after a previous disconnect. TradingForge will resume normal operation. |
| Rate Limit Warning | System | No | TradingForge is approaching the exchange's API rate limit. This is typically caused by running too many active pairs or having a very short analysis interval in TradeSmith. |
Configuring Which Alerts to Receive
Navigate to Settings → Notifications to control which alert types are active. You can configure each channel (Telegram, email) independently — for example, send all alerts to Telegram but only error and trade-closed alerts to email.
- ›For active monitoring: Enable all trade events and engine events on Telegram so you always know what the bot is doing.
- ›For a quieter setup: Disable Trade Opened and Safety Order Triggered, and only keep Take Profit Hit, Engine Error, and Insufficient Balance enabled.
- ›For email: Restrict to high-importance events only (trade closed, engine error, insufficient balance) to avoid inbox clutter.
The "Max Safety Orders Reached" alert is particularly useful. If you receive this alert, log in to the dashboard and assess whether you want to manually close the position, wait for price recovery, or adjust your strategy configuration.