SignalBridge Telegram to MT5 Orchestrator

TradingView & Telegram → MT5 Automation + Position Management

This is an integrated execution and risk/position management EA for MT5 that lets you:

• Automate trades from TradingView strategy alerts (via secured webhook → desktop bridge → EA)
• Manually trigger trades using Telegram bot commands (e.g., “Long EURUSD”, “Close XAUUSD”, “Short GBPJPY r=1 rt=fixed”)
• Run both methods in parallel; every instruction is normalized into structured “signal drop” files that the EA ingests and executes on MT5 with uniform risk controls and management logic.

How It Works

1. Signal Sources (Choose One or Both):

   • Automated path: TradingView sends alerts via webhook URLs generated by a companion desktop app.
   • Manual path: You interact with your Telegram bot (keyboard or typed commands)

2. Transport & Normalization:
   The companion desktop application (SignalBridge) receives either webhook payloads or Telegram commands, applies formatting and validation, then writes signal files to a shared folder.

3. EA Ingestion & Validation:
   The MT5 EA continuously scans for new signal drops, verifies:

   • Webhook ID (optional)
   • Freshness vs. expiry window
   • Duplicate protection

4. Risk Layer Enforcement:
   Before order placement, the EA applies cumulative daily limits, per‑trade loss protections, static account-size guard (optional), max trades per symbol/direction, and spread/slippage filters.

5. Execution & Lifecycle Management:
   Orders are placed with retry logic. Active positions are continuously managed (breakeven, trailing stops, staged partial closes, enforced drawdown exits). Trade-closing (TP/SL) events generate immediate Telegram notifications.

Core Modules

1. Signal Engine

• Watches a dedicated “signal drop” directory
• Validates timestamp, expiry, Webhook ID (if enforced), and dedupes processed IDs
• Supports multi-symbol execution from a single chart instance (per-symbol filters applied at runtime)

2. Risk Manager

• Daily trade count ceiling
• Cumulative PnL percentage caps (gain + loss) with forced flattening
• Per-trade max loss (dynamic based on grouped entries)
• Static account-size safeguard (currency or % baseline until manually reset)
• Spread/slippage/max open lots/direction quotas

3. Trade Manager

• Resilient order dispatch with retry queue
• Volume calculation: fixed lots or percent risk (ATR/points SL normalization)
• Multi-attempt logic with timed backoff
• Supports partial volume scaling (split risk)

4. Position Management

• Breakeven trigger (ATR or points mode)
• Trailing stop (ATR, points, or prior candle high/low with buffer)
• Staged partial exits: TP1, TP2, Drawdown-triggered partial SL
• Reverse TP/SL calculations stored for alternative scenario labeling

5. News Filter (Optional)

• Daily economic calendar fetch (lightweight)
• Per-symbol impact gating (High/Medium/Low) with pre/post blackout windows

6. Notification Layer

• Telegram alerts for TP/SL/Trailing/Breakeven closures with cooldown for non-critical events
• Limit breach alerts (daily loss/gain, account-size guard)
• Structured trade-close summaries (PnL + duration + reason)

7. Visual & UI Overlay

• Entry price, aggregated average line (multi-position)
• Live TP/SL/partial trigger levels
• Real-time metrics panel (PnL %, daily limits, lot exposure, safeguard status)

Key Features Overview

• Dual ingestion (Webhook + Telegram)
• Account size circuit breaker
• Intelligent notification scheduling for all trade events
• Partial exit architecture (profit scaling + defensive drawdown trimming)
• Visual execution telemetry for situational awareness
• Fully file-based integration - no DLLs required

Usage Workflow (Quick Start)

1. Install & Attach EA to any MT5 chart (one instance can process multi-symbol signals)
2. Configure Inputs:
   • Risk parameters (percent or fixed)
   • Daily limits & account-size guard (optional)
   • Partial/trailing/breakeven logic
3. (Optional) Enable News Filter: Add calendar URL to MT5 WebRequest list
4. Set Signal Expiry Minutes to prevent stale execution
5. Desktop App Setup:
   • (TradingView Path) Create webhook (URL auto-generated) and paste into TradingView alert(s)
   • (Telegram Path) Add bot token + start chat → send commands (e.g., “Long EURUSD r=1 rt=percent”)
6. Monitor EA Panel: Confirm live metrics, PnL, trade limits, and incoming signal acknowledgments
7. Validate Notifications: TP/SL/partial/breakeven events should arrive in Telegram with proper formatting
8. Refine & Scale: Adjust ATR multiples, partial thresholds, or trailing buffer after demo validation

Command Examples

Safeguards

• Hard Daily Loss & Gain Locks: Auto-close + block new entries (with Telegram alert)
• Per-Trade Loss Enforcement: Forced closure if allocated slice breaches envelope
• Account Size Guard: Persistent across restarts until manually reset (gain or loss threshold)
• Spread & Slippage Filters: Declines entries in adverse microstructure conditions
• Queued Retries: Avoids terminal freezing under transient trade context busy states

Best Practices

• Always demo first to calibrate ATR multiples & partial scaling.
• Use unique Webhook IDs per strategy cluster for traceability.
• Keep Telegram risk defaults conservative; override per command if needed.