CALLIDUS EA v2.0 – OFFICIAL USER MANUAL

The Adaptive, ML-Powered Multi-Symbol Trading Framework

1. OVERVIEW & PHILOSOPHY
Callidus EA is not a simple "set and forget" bot with a single strategy. It is a dynamic trading framework designed to identify the current market state (Regime) and deploy the correct mathematical model to exploit it.

It combines three cutting-edge technologies:

Regime Detection: Uses ADX to determine if the market is Trending or Ranging.
Dual-Engine Execution: Switches between Trend-Following strategies and Mean-Reversion strategies automatically.
AI Validation: A Random Forest Machine Learning model (composed of multiple decision trees) filters every signal, assigning a probability score (0-100%) to the setup.

2. INSTALLATION GUIDE

2.1. Standard Installation
Open your MetaTrader 5 terminal.
Download Callidus EA from the Market tab.
Refresh your Navigator window (Ctrl+N). The EA will appear under "Market".

2.2. Chart Setup (Crucial!)
Callidus is a Multi-Symbol EA. You do NOT need to open charts for every pair you want to trade.

Open ONE single chart. We recommend EURUSD on the M1 timeframe.
Note: The EA calculates logic on your chosen TradeTF (e.g., H1), but running it on an M1 chart ensures the EA wakes up frequently to manage trades.
Drag the EA onto the chart.
In the inputs, set SymbolsList to the pairs you wish to trade (e.g., EURUSD,GBPUSD,XAUUSD).

2.3. VPS Setup (The "Keep-Alive" Feature)
To ensure features like Trailing Stops and Basket Closure work 24/7 on the MQL5 VPS, you must enable the internal heartbeat:

Go to Inputs -> VPS & Performance.
Set EnableVpsKeepAlive = true.
Set VpsKeepAliveSymbol = EURUSD.
When synchronizing to MQL5 VPS, ensure you select "Synchronize Environment".

3. INCLUDED PRESET FILES (.set)
We have included several optimized preset files to help you get started. Load these via the "Inputs" tab > "Load" button. You can find them in the Presets folder inside the MQL5 folder. The default setup is optimized for XAUUSD trading only. You have to change this for your desired currency pair and optimize it.

4. DETAILED PARAMETER GUIDE

🔹 Strategy & Entry Logic
TrendingStrategy:
TRENDING_EMA_CROSSOVER: Classic trend following. Fast/Slow EMA cross.
TRENDING_ADX_CROSSOVER: (New) Uses the Directional Movement system (DI+ / DI-) to confirm trend direction and strength.
RangingStrategy:
RANGING_SR_PULLBACK: Uses Fractals to find Support/Resistance. Trades the bounce.
RANGING_BB_PULLBACK: Trades mean-reversion when price breaches Bollinger Bands.
EnableADXFilter: The "Master Switch." If ADX is below ADXRangingThreshold, it uses the Ranging Strategy. If above ADXTrendingThreshold, it uses the Trending Strategy.

🔹 Machine Learning (Random Forest)
MinMLThreshold: The confidence score (0.0 to 1.0) required to take a trade.
0.50: Neutral. Takes all valid signals.
0.60: Standard filtering. Removes ~40% of weak signals.
0.80+: Sniper mode. Very few trades, extremely high probability.

🔹 Hedging & Recovery Modes (The Risk Engine)
This is the most powerful part of Callidus. Choose your risk style via HedgeMode:

MODE_BASKET (Conservative):

Opens counter-trades with fixed lot sizes.
Goal: Wait for the net profit of the original + hedge to be positive, then close all.
Safety: Does not increase lot sizes exponentially.

MODE_RECOVERY (Grid / Averaging):

Opens new trades in the SAME direction as the losing trade.
Uses HedgeMultiplier (e.g., 1.5x) to increase lot size.
Goal: Lower the average entry price so a small reversal clears the profit target.

MODE_MARTINGALE (Aggressive Hedge):

Opens new trades in the OPPOSITE direction with increased lot sizes.
Goal: Profit from the reversal immediately.

🔹 Basket Management Settings
CloseProgressiveTradesByBasketOnly:
TRUE (Recommended): New recovery trades have NO individual Take Profit. They stay open until the entire basket (all trades combined) hits the target.
FALSE: Trades can close individually (can leave you with "orphaned" losing trades).
BasketCloseAtBreakEven: If true, the EA will close the whole basket the moment it reaches $0.00 profit. This is a "safety first" exit to escape drawdown quickly.
BasketStopLoss: A hard dollar value (e.g., -150.0). If the basket floats this much loss, EVERYTHING CLOSES. This is your catastrophic protection.

5. TROUBLESHOOTING FAQ

Q: The EA is not opening trades.
A: Check your MinMLThreshold. If it's set to 0.8, the EA is waiting for a near-perfect setup. Lower it to 0.55 or 0.60. Also, check the "Experts" tab for "Invalid Handle" errors.

Q: My Recovery trades aren't closing.
A: If you enabled CloseProgressiveTradesByBasketOnly, they are waiting for the Net Profit of the group to be positive. If the original trade is in deep loss, the recovery trades must profit enough to cover that loss. Enable BasketCloseAtBreakEven for faster exits.

Q: I see "Error 403" in the Journal.
A: This is an MQL5 login error. Go to Tools > Options > Community and re-enter your MQL5 login and password.

Q: Does it work on Prop Firms?
A: Yes, but use MODE_BASKET or MODE_NONE. Most prop firms ban Martingale strategies (MODE_RECOVERY/MODE_MARTINGALE).

6. DISCLAIMER
Automated trading involves significant risk. The MODE_RECOVERY and MODE_MARTINGALE strategies involve progressive exposure and should be used with caution and strict Stop Losses. Past performance of the Machine Learning model does not guarantee future results.