MAEA/plans/MAEA-summary.md

MAEA Project Summary

Project Overview

MAEA (Moving Average Expert Advisor) - An advanced trend-following trading robot for MetaTrader 5 with sophisticated filtering and risk management features.

Repository: https://git.moreminimore.com/kunthawat/MAEA
Timezone: Thailand (UTC+7)

Core Strategy

Indicator System (2 EMA Lines + Zone)

1. EMA High (Light Blue) - EMA of High prices, period 30
2. EMA Low (Orange) - EMA of Low prices, period 30
3. Zone Fill (Light Yellow, transparent) - Area between EMA High and EMA Low

Signal Types

1. Breakthrough Signal

• Buy: Close price breaks above EMA High (must have previous close inside zone)
• Sell: Close price breaks below EMA Low (must have previous close inside zone)
• Purpose: Triggers position opening
• Verification: Previous bar close must be inside zone between EMA High and EMA Low

2. Opposite Signal Close

• Close Buy: When sell signal occurs (price breaks below EMA Low)
• Close Sell: When buy signal occurs (price breaks above EMA High)
• Immediate Action: Position closes before checking for new trade

Order Management

• Single Position: Only one position open at a time (MT5 uses positions, not orders)
• Fixed Lot Size: 0.01 lot for all trades
• Stop Loss: At opposite EMA (Buy: EMA Low, Sell: EMA High)
• Reverse Protection: Close position when opposite signal occurs
• Min Zone Width: Zone must be at least 100 points to trade
• Take Profit: Target in USD (default $5)
• Breakeven: Move SL to entry at X points profit (default 100)
• Trailing Stop: Trail by X points after breakeven (default 100)

Advanced Filters

1. Volume Filter

• Calculate 20-bar volume average
  • Trade only when current volume > average
  • Ensures sufficient market activity
  • Note: MT5 uses tick volume by default (similar to MT4)

2. Spread Filter

• Maximum allowed spread: 30 points
• Prevents trading during high spread periods

3. Multiple Timeframe (MTF) Filter (Optional)

• Trading Timeframe: H1
• Filter Timeframe: D1
• Logic:
  • D1 close > D1 EMA High: Only buy positions allowed (bullish)
  • D1 close < D1 EMA Low: Only sell positions allowed (bearish)
  • D1 close between: No positions allowed (no trend)
• Can be enabled/disabled

4. News Filter (Optional)

• Avoid specific hours (default: 14, 15, 20, 21)
• Avoid specific days (default: 1, 5)
• All times in Thailand timezone (UTC+7)
• Can be enabled/disabled

5. Risk Management

• Max Drawdown: Percentage-based protection (default 10%)
• Stops trading if drawdown exceeds limit
• Resumes trading when drawdown is below limit

6. Zone Width Filter

• Min Zone Width: 100 points minimum before trading
• Ensures meaningful trend setups
• Prevents trading during tight consolidation

Implementation Phases

Phase 1: Project Setup & Git Configuration (3 tasks)

• Create MQL5 project structure
• Initialize Git repository
• Configure remote to Gitea server

Phase 2: Core EA Structure (4 tasks)

• Create MAEA.mq5 with basic framework
• Define all input parameters
• Set up indicator buffers
• Initialize global variables

Phase 3: Indicator Calculations (4 tasks)

• Implement EMA calculations (High and Low only)
• Implement zone fill between EMA High and EMA Low
• Add visual indicators with colors (Light Blue, Orange, Light Yellow fill)
• Implement Volume average calculation

Phase 4: Signal Detection (3 tasks)

• Implement breakthrough signal detection
  • Check if previous close inside zone
  • Check if current close broke above EMA High or below EMA Low
• Implement opposite signal detection and position closing
  • Close buy position when sell signal occurs
  • Close sell position when buy signal occurs
• Implement minimum zone width check (100 points)

Phase 5: Multiple Timeframe Filter (3 tasks)

• Implement D1 EMA calculations
• Implement MTF filter logic
• Add enable/disable toggle

Phase 6: Additional Filters (4 tasks)

• Implement volume filter
• Implement spread filter
• Implement news filter (Thailand timezone)
• Add enable/disable toggle for news filter

Phase 7: Order Management (7 tasks)

• Implement position opening with all filters
• Implement fixed lot sizing (0.01 lot)
• Implement Stop Loss placement at opposite EMA
• Implement Take Profit calculation
• Implement Breakeven logic
• Implement Trailing Stop logic
• Implement single position restriction

Phase 8: Risk Management (3 tasks)

• Implement max drawdown calculation
• Implement drawdown protection
• Implement trading resume logic

Phase 9: Order Monitoring & Management (6 tasks)

• Implement opposite signal checking on each tick
• Close position when opposite signal detected
• Implement Take Profit checking
• Implement Breakeven checking and SL modification
• Implement Trailing Stop checking and SL modification
• Implement Stop Loss checking
• Implement position closure logic

Phase 10: Testing & Validation (8 tasks)

• Test EMA High and Low calculations
• Test zone fill visualization
• Test zone width calculation
• Test minimum zone width filter (100 points)
• Test breakthrough signal detection (with zone check)
• Test opposite signal detection and position closing
• Test all filters
• Test position opening with fixed 0.01 lot
• Test TP, SL, breakeven, and trailing stop
• Test drawdown protection
• Test visual indicators display

Phase 11: Documentation & Deployment (5 tasks)

• Create comprehensive README.md
• Add parameter descriptions and usage instructions
• Add troubleshooting guide
• Commit initial code to Git
• Push to Gitea repository and verify

Total Tasks: 51

Key Features Summary

✅ Simple Trend Following: EMA-based with visual zone fill
✅ Clear Breakthrough Signals: Zone breakout with previous bar confirmation
✅ Reverse Protection: Positions close when opposite signal occurs
✅ Minimum Zone Width: 100 points requirement for meaningful setups
✅ Fixed Lot Size: Consistent 0.01 lot position sizing
✅ Comprehensive Filters: Volume, spread, MTF, news, and drawdown protection
✅ Risk Management: TP in USD, SL at opposite EMA, breakeven, trailing stop
✅ Visual Indicators: 2 EMAs with light yellow zone fill
✅ Flexible Configuration: All features can be enabled/disabled
✅ Single Position Management: Prevents over-trading
✅ Timezone Aware: Thailand timezone (UTC+7) for all time-based features

Default Parameters

Parameter	Value	Description
EMA Period	30	Period for EMA High and EMA Low
Lot Size	0.01	Fixed lot size for all trades
Take Profit	$5	Target profit in USD
Breakeven Points	100	Points to trigger breakeven
Trailing Stop Points	100	Trail distance after breakeven
Max Spread	30 points	Maximum allowed spread
Volume Period	20	Bars for volume average
Min Zone Width	100 points	Minimum zone width to trade
Max Drawdown	10%	Maximum drawdown percentage
MTF Filter	true	Enable/disable MTF filter
News Filter	true	Enable/disable news filter

Technical Specifications

• Platform: MetaTrader 5
• Language: MQL5
• Trading Timeframe: H1 (recommended)
• Filter Timeframe: D1 (for MTF)
• Currency Pairs: All pairs (user-selectable)
• Account Types: Any MT5 account
• Server Timezone: Thailand (UTC+7)

Next Steps

The implementation plan is complete and ready for execution. All 50 tasks have been clearly defined and organized into 11 logical phases. The plan includes:

1. ✅ Detailed strategy documentation
2. ✅ Visual flow diagram
3. ✅ Complete implementation steps
4. ✅ Input parameters table
5. ✅ Testing checklist
6. ✅ Technical specifications

Ready to proceed with implementation in Code mode.