LTT Range Bot

================================================================================
LTT RANGE BOT EA - PRODUCT DESCRIPTION
================================================================================

Overview

LTT Range Bot EA is an automated trading system that implements a time-based range breakout strategy. The Expert Advisor identifies price ranges during specified time periods and places pending orders to trade breakouts above or below these ranges with precise risk-reward ratios.

This EA is designed for traders who understand the importance of defined market ranges and breakout trading in volatile market conditions, particularly during key market sessions.

================================================================================

TRADING STRATEGY

The LTT Range Bot EA implements a systematic range-based approach:

1. TIME RANGE IDENTIFICATION
   - Monitors price action during user-defined time windows
   - Automatically identifies the highest and lowest price levels
   - Updates range boundaries in real-time during active range period
   - Visualizes range with horizontal lines and vertical time markers

2. PENDING ORDER PLACEMENT
   - Places Buy Stop order above range high with configurable offset
   - Places Sell Stop order below range low with configurable offset
   - Automatically calculates Stop Loss at opposite range boundary
   - Sets Take Profit based on configurable Risk-Reward Ratio

3. POSITION MANAGEMENT
   - Option to keep or delete opposite pending order when one triggers
   - Automatic deletion of opposite order when Take Profit is reached
   - Configurable order lifetime with automatic expiration
   - Trading mode selection: Both directions, Long only, or Short only

4. INTELLIGENT ORDER CANCELLATION
   - Long-only mode: Deletes Buy Stop if price crosses below range low
   - Short-only mode: Deletes Sell Stop if price crosses above range high
   - Prevents unfavorable entries after invalidated setups

5. SESSION CONTROL
   - Individual day-of-week activation (Monday through Friday)
   - Optional automatic position closure at specified time
   - Daily range reset for fresh trading opportunities

================================================================================

RISK MANAGEMENT

The EA includes comprehensive risk management features:

POSITION SIZING - THREE CALCULATION MODES
- Fixed Lot Size: Constant position size regardless of account balance
- Fixed Risk Money: Risk a specific amount in account currency per trade
- Risk Percentage: Risk a percentage of account balance per trade
- Uses OrderCalcProfit() for accurate lot calculation across all instruments
- Fallback calculation method for maximum reliability
- User-defined minimum and maximum lot size limits
- Automatic normalization to broker's volume step requirements

STOP LOSS & TAKE PROFIT
- Automatic Stop Loss placement at opposite range boundary
- Risk-Reward Ratio based Take Profit (default: 2.0)
- Natural stop placement based on actual market structure

BREAKEVEN PROTECTION
- Automatic breakeven activation at configurable RR level
- Moves Stop Loss to entry price to eliminate risk
- Protects capital once trade moves favorably

TRAILING STOP
- Optional trailing stop functionality
- Activation threshold based on Risk-Reward ratio
- Configurable trailing step in points
- Locks in profits as position moves favorably

================================================================================

SESSION MANAGEMENT

Flexible trading schedule with comprehensive controls:

TIME RANGE SETTINGS
- Configurable start time (hour and minute)
- Configurable end time (hour and minute)
- Automatic range calculation during active period
- Order placement immediately after range closes

DAY-OF-WEEK FILTERS
- Individual enable/disable for each weekday
- Monday through Friday independent activation
- Prevents trading on unfavorable days
- Automatic weekend exclusion

CLOSE TRADE TIME
- Optional automatic position closure at specified time
- Independent hour and minute settings
- Prevents overnight exposure if desired
- Daily reset for consistent behavior

================================================================================

KEY FEATURES

RANGE VISUALIZATION
- Real-time range high and low horizontal lines
- Customizable line colors and width
- Vertical markers showing range start and end times
- Visual confirmation of range boundaries on chart

CHART CUSTOMIZATION
- Complete chart color scheme control
- Background and foreground color settings
- Bullish and bearish candle colors
- Optional grid display
- Professional chart presentation

RISK CALCULATION
- Advanced lot size calculation using OrderCalcProfit()
- Safest account value calculation (minimum of Balance, Equity, Free Margin)
- Protection against over-risking during drawdowns
- MathFloor-based normalization prevents exceeding intended risk
- Comprehensive error handling and validation

TRADING MODES
- Both Directions: Trade breakouts in both directions
- Long Only: Only trade upward breakouts
- Short Only: Only trade downward breakouts
- Dynamic mode switching without EA restart

TECHNICAL SPECIFICATIONS
- Efficient tick processing with minimal CPU usage
- Clean object management on chart
- Automatic cleanup on EA removal
- Compatible with all timeframes and symbols
- Works with both real and tick volume data

================================================================================

INPUT PARAMETERS

TIME RANGE SETTINGS
- Range Start Hour: Hour when range monitoring begins
- Range Start Minute: Minute when range monitoring begins 
- Range End Hour: Hour when range closes and orders are placed
- Range End Minute: Minute when range closes 

TRADE DAYS
- Trade Monday: Enable/disable Monday trading
- Trade Tuesday: Enable/disable Tuesday trading
- Trade Wednesday: Enable/disable Wednesday trading
- Trade Thursday: Enable/disable Thursday trading
- Trade Friday: Enable/disable Friday trading

LINE SETTINGS
- High Line Color: Color of range high line
- Low Line Color: Color of range low line
- Line Width: Width of range lines
- Range Marker Color: Color of start/end time markers 

RISK MANAGEMENT
- Initial Lot Mode: Fixed Lot, Fixed Risk Money, or Risk Percent
- Fixed Lot Size: Size when using Fixed Lot mode
- Risk Money: Amount in account currency to risk 
- Initial Risk Percent: Percentage of balance to risk 
- Max Lot Size: Maximum allowed position size 
- Min Lot Size: Minimum allowed position size 

ORDER SETTINGS
- Order Offset: Distance in points from range boundary (default: 10.0)
- Risk Reward Ratio: Take Profit multiplier of Stop Loss (default: 2.0)
- Order Lifetime Minutes: Duration before pending orders expire (default: 1440)
- Keep Opposite Order: Whether to keep opposite order when one triggers
- Delete Opposite On TP: Delete opposite order when Take Profit is hit

CLOSE TRADE TIME
- Use Close Trade Time: Enable automatic position closure
- Close Trade Hour: Hour to close all positions
- Close Trade Minute: Minute to close all positions

BREAKEVEN & TRAILING STOP
- Use Breakeven: Enable breakeven functionality 
- Breakeven RR: RR level to activate breakeven 
- Use Trailing Stop: Enable trailing stop functionality
- Trailing Stop RR: RR level to start trailing 
- Trailing Step Points: Distance in points for trailing stop

RECOMMENDED USAGE

TIMEFRAMES
- Works on all timeframes
- M5 and M15 recommended for short-term ranges
- H1 recommended for session-based ranges
- Higher timeframes for daily range breakouts

SYMBOLS
- Best performance on liquid markets with clear ranges
- Forex majors during active sessions (London, New York open)
- Indices during opening hours
- Commodities with defined trading sessions
- Backtest on your specific symbol before live trading

RANGE TIME SELECTION
- Asian session ranges (typically quieter, clearer ranges)
- Pre-London/New York ranges for breakout opportunities
- Overnight ranges for European/US session breakouts
- Avoid major news release times unless specifically trading the volatility

OPTIMIZATION SUGGESTIONS
- Test different range start/end times for your market
- Optimize Risk-Reward Ratio based on historical breakout behavior
- Adjust Order Offset to balance entry timing and false breakout filtering
- Calibrate Breakeven RR to protect profits while allowing room to run
- Test different Order Lifetime settings to avoid stale setups

DAY-OF-WEEK OPTIMIZATION
- Backtest performance by individual weekday
- Disable days with historically poor performance
- Consider Monday vs. Friday volatility differences
- Account for weekly patterns in your specific market

================================================================================

DISCLAIMER

Trading foreign exchange, commodities, indices, and other leveraged products
carries a high level of risk and may not be suitable for all investors. Before
deciding to trade, you should carefully consider your investment objectives,
level of experience, and risk appetite. There is a possibility that you may
sustain a loss of some or all of your investment. You should only trade with
money you can afford to lose.

The EA does not guarantee profits. Trading carries substantial risk of loss.

This Expert Advisor is a tool to assist in trading decisions. The developer
is not responsible for any losses incurred through the use of this software.

Range breakout strategies can experience extended losing streaks during
ranging or choppy market conditions. Proper risk management and position
sizing are essential for long-term success.

Always test thoroughly on a demo account before risking real capital.

================================================================================