Breakout AI Pro is not just another breakout bot. It combines proven price-action breakout logic with 6 AI-powered adaptive modules that analyze market context before every single entry. The result: fewer false breakouts, smarter SL/TP placement, and consistent risk management across any instrument.

=== HOW IT WORKS ===

The bot calculates the highest high and lowest low over a configurable lookback period. When price interacts with these levels, it detects 3 types of signals:

- BREAK: Price has just broken through the level. Classic momentum/continuation signal.

- APPROACH: Price is within X pips of the level without breaking it. Anticipation signal.

- RETURN: Price broke through but came back inside. Mean-reversion / trap signal.

For each signal type (Break, Approach, Return) on both High and Low levels, you can independently enable BUY and/or SELL entries. This gives you full control over your strategy: trend-following, counter-trend, or hybrid.

Before any position is opened, the signal passes through 7 sequential AI filters. If it fails any one of them, the trade is discarded.

=== 6 AI MODULES ===

1. VOLATILITY REGIME DETECTION

Uses ATR percentiles to classify the market as Low, Medium, or High volatility. In Low volatility, breakouts are statistically more likely to be false — the bot blocks entries automatically. In High volatility, SL/TP are widened to accommodate larger moves.

2. RSI MOMENTUM FILTER

Blocks BUY entries when RSI is overbought and SELL entries when RSI is oversold. Optional divergence detection adds an extra layer of confirmation. This prevents entries at exhausted momentum extremes.

3. ADAPTIVE SL/TP (ATR-BASED)

Stop Loss and Take Profit are calculated as multiples of the current ATR — not fixed values. The bot adapts to real market conditions: tight SL in calm markets, wider SL in volatile markets. Min/Max clamps ensure values always stay within your defined boundaries.

4. ENTRY QUALITY SCORE

Every signal receives a score from 0 to 100 based on 4 factors:

- Volatility regime (Medium is best for breakouts)

- RSI alignment with trade direction

- Breakout strength (distance from level relative to ATR)

- Candle quality (normal range vs spike vs doji)

Only signals above your minimum threshold are executed.

5. DYNAMIC POSITION SIZING

Instead of fixed lots, the bot calculates volume based on your risk percentage per trade and the adaptive SL distance. Optionally scales position size by quality score — higher confidence = larger position, lower confidence = smaller position.

6. SMART COOLDOWN SYSTEM

After a stop loss hit, the bot waits a configurable number of bars before re-entering the same signal type. This prevents the destructive loop of SL → immediate re-entry → SL → re-entry that can drain accounts.

=== SAFETY FEATURES ===

- UNIT SELECTOR: Choose whether all SL/TP/BE/Trailing inputs are in PIPS or PRICE DISTANCE. Works perfectly on any instrument — Forex, Crypto, Indices, Commodities.

- ANTI-OPPOSING PROTECTION: Prevents opening BUY and SELL on the same bar.

- SL/TP ENFORCEMENT: Every tick, the bot verifies that all open positions have valid SL and TP. If missing, emergency values are applied immediately.

- SL VERIFICATION: After opening a position, the bot confirms SL was actually applied. If the broker rejects it, the position is closed instantly. No unprotected positions ever.

- MAX EXPOSURE CONTROL: Configurable limits for max LONG positions, max SHORT positions, and max total positions.

=== PROP FIRM READY ===

Built-in daily and total drawdown monitoring in account currency. When limits are breached, choose from 3 actions:

- Close All: Immediately closes all positions and blocks new entries for the day.

- Block New: Keeps existing positions but prevents new ones.

- Hedge: Opens opposite positions to lock in current P&L.

=== POSITION MANAGEMENT ===

- BREAK EVEN: Moves SL to entry price + offset once profit reaches the trigger level. Locks in a small guaranteed profit.

- TRAILING STOP: Once profit reaches the start level, SL follows price at a fixed distance. Lets winners run while protecting gains.

- All values respect your chosen unit system (pips or price distance).

=== PARAMETER GUIDE ===

1. BASE PARAMETERS

- PreviousPeriodBars (48): Number of bars for High/Low calculation. 48 bars on M5 = 4 hours.

- OnBarOnly (true): Check conditions on bar close (stable) or every tick (reactive).

- VolumeLots (0.1): Fixed volume per trade. Ignored if Dynamic Sizing is enabled.

1b. UNIT SYSTEM

- InputInPips (true): If true, all SL/TP/BE/Trailing values are in PIPS. If false, they are in price distance. Critical for correct operation on different instruments.

2. AI — VOLATILITY

- EnableVolatilityFilter (true): Enable ATR-based regime classification.

- AtrPeriod (14): ATR indicator period.

- AtrLookback (50): Number of ATR bars for percentile calculation.

- LowVolPercentile (25): Below this percentile = Low regime.

- HighVolPercentile (75): Above this percentile = High regime.

- BlockLowVolatility (true): Block all entries during Low volatility.

3. AI — MOMENTUM

- EnableRsiFilter (true): Enable RSI-based entry filtering.

- RsiPeriod (14): RSI indicator period.

- RsiOverbought (70): Overbought threshold.

- RsiOversold (30): Oversold threshold.

- BlockBuyOverbought (true): Block BUY when RSI >= overbought.

- BlockSellOversold (true): Block SELL when RSI <= oversold.

- RequireDivergenceConfirmation (false): Block entries on RSI/price divergence.

- DivergenceLookback (10): Bars to check for divergence.

4. AI — ADAPTIVE SL/TP

- EnableAdaptiveSLTP (true): Calculate SL/TP from ATR. If false, uses fixed values.

- AtrMultiplierSL (1.5): SL = ATR x multiplier.

- AtrMultiplierTP (2.5): TP = ATR x multiplier. Default R:R ratio = 1.67.

- MinSL (500): Minimum SL (in your chosen unit).

- MaxSL (5000): Maximum SL. Clamp is applied AFTER volatility adjustment.

- MinTP (800): Minimum TP.

- MaxTP (10000): Maximum TP.

5. AI — QUALITY SCORE

- EnableQualityScore (true): Enable signal quality scoring.

- MinQualityScore (40): Minimum score (0-100) to open a trade.

6. AI — DYNAMIC SIZING

- EnableDynamicSizing (false): Calculate volume from risk %.

- RiskPercentage (1.0): % of equity to risk per trade.

- ScaleByQuality (true): Reduce volume for low-quality signals (min 30%).

6b. AI — COOLDOWN

- CooldownBarsAfterSL (6): Bars to wait after a stop loss before re-entering same signal.

- BlockOpposingOnSameBar (true): Prevent BUY+SELL on the same bar.

- MaxTotalPositions (2): Maximum total open positions.

7. BREAK HIGH

- BuyOnBreakHigh (true): Open BUY on high breakout.

- SellOnBreakHigh (false): Open SELL on high breakout (counter-trend).

- ApproachPipsHigh (15): Distance in pips for approach detection.

- BuyOnApproachHigh (false): Open BUY on approach to high.

- SellOnApproachHigh (false): Open SELL on approach.

- BuyOnReturnHigh (false): Open BUY on return below high.

- SellOnReturnHigh (false): Open SELL on return.

8. BREAK LOW

- SellOnBreakLow (true): Open SELL on low breakout.

- BuyOnBreakLow (false): Open BUY on low breakout (counter-trend).

- ApproachPipsLow (15): Distance for approach detection.

- All Approach/Return options same as Break High.

9. POSITION LIMITS

- MaxLong (1): Max simultaneous LONG positions.

- MaxShort (1): Max simultaneous SHORT positions.

10. RISK MANAGEMENT (FIXED)

- StopLossLong/Short (3000): Fixed SL when Adaptive is OFF.

- TakeProfitLong/Short (6000): Fixed TP when Adaptive is OFF.

- BreakEven trigger/offset: When profit hits trigger, SL moves to entry + offset.

- Trailing start/step: When profit hits start, SL follows price at step distance.

11. PROP RISK CONTROL

- EnablePropRisk (true): Enable drawdown monitoring.

- MaxDailyDrawdown (500): Max daily loss in account currency.

- MaxTotalDrawdown (1500): Max total loss from bot start.

- OnBreachAction (0): 0=Close All, 1=Block New, 2=Hedge.

- HedgeVolumeMultiplier (1.0): Volume multiplier for hedge positions.

=== SUGGESTED CONFIGURATIONS ===

BTCUSD M5 (Crypto):

InputInPips=false, MinSL=200, MaxSL=1500, MinTP=300, MaxTP=3000, BE trigger=400, Trailing step=150, PreviousPeriodBars=48.

EURUSD M15 (Forex):

InputInPips=true, MinSL=15, MaxSL=80, MinTP=25, MaxTP=150, BE trigger=30, Trailing step=10, PreviousPeriodBars=96.

US30 M5 (Indices):

InputInPips=false, MinSL=30, MaxSL=200, MinTP=50, MaxTP=400, PreviousPeriodBars=48.

=== IMPORTANT NOTES ===

- All AI modules can be enabled/disabled independently. Start with all ON (default) and disable individually to test impact.

- The bot logs every decision with both price and pip values. Check the log at startup to verify your unit conversion is correct.

- Always test on demo account first. Past performance does not guarantee future results.

- Trading involves significant risk. This software is a trading automation tool, not financial advice.