MAEA/plans/MAEA-summary.md

MAEA Project Summary

Project Overview

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

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

Core Strategy

Indicator System (5 Visual Lines)

1. EMA High (Light Blue) - EMA of High prices, period 30
2. EMA Medium (Yellow) - EMA of Close prices, period 30
3. EMA Low (Orange) - EMA of Low prices, period 30
4. High Border (Purple) - EMA High + (EMA Medium - EMA Low)
5. Low Border (Purple) - EMA Low - (EMA Medium - EMA Low)

Signal Types

1. Breakthrough Signal

• Buy: Close price breaks above EMA High
• Sell: Close price breaks below EMA Low
• Purpose: Triggers order opening

2. Pullback Signal

• Buy Pullback: Price moves down to hit any line, then closes above the line
• Sell Pullback: Price moves up to hit any line, then closes below the line
• Purpose: Increases lot size when breakthrough occurs in same direction
• Tracking: Separate for buy and sell directions

Order Management

• Single Order: Only one order at a time
• Dynamic Lot Sizing:
  • 0.01 lot (no pullback before breakthrough)
  • 0.02 lot (pullback occurred before breakthrough)
• Stop Loss: At Border Lines (Low Border for buys, High Border for sells)
• 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

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 orders allowed
  • D1 close < D1 EMA Low: Only sell orders allowed
  • D1 close between: No orders allowed
• 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

Implementation Phases

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

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

Phase 2: Core EA Structure (4 tasks)

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

Phase 3: Indicator Calculations (4 tasks)

• Implement EMA calculations (High, Medium, Low)
• Implement Border Line calculations
• Add visual indicators with colors
• Implement Volume average calculation

Phase 4: Signal Detection (4 tasks)

• Implement breakthrough signal detection
• Implement pullback signal detection
• Implement separate pullback tracking
• Implement pullback flag reset logic

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 order opening with all filters
• Implement dynamic lot sizing
• Implement Stop Loss placement
• Implement Take Profit calculation
• Implement Breakeven logic
• Implement Trailing Stop logic
• Implement single order restriction

Phase 8: Risk Management (3 tasks)

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

Phase 9: Order Monitoring & Management (5 tasks)

• Implement Take Profit checking
• Implement Breakeven checking and SL modification
• Implement Trailing Stop checking and SL modification
• Implement Stop Loss checking
• Implement order closure logic

Phase 10: Testing & Validation (7 tasks)

• Test all EMA and Border Line calculations
• Test breakthrough and pullback signals
• Test all filters
• Test order opening with correct lot sizes
• 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: 50

Key Features Summary

✅ Advanced Trend Following: EMA-based with dynamic border lines
✅ Smart Signal Detection: Breakthrough and pullback signals with separate tracking
✅ Dynamic Lot Sizing: 0.01 or 0.02 based on market behavior
✅ Comprehensive Filters: Volume, spread, MTF, news, and drawdown protection
✅ Risk Management: TP in USD, SL at borders, breakeven, trailing stop
✅ Visual Indicators: 5 colored lines for easy analysis
✅ Flexible Configuration: All features can be enabled/disabled
✅ Single Order 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 all EMAs
Lot Size (Normal)	0.01	Lot without pullback
Lot Size (Pullback)	0.02	Lot with pullback
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
Max Drawdown	10%	Maximum drawdown percentage
MTF Filter	true	Enable/disable MTF filter
News Filter	true	Enable/disable news filter

Technical Specifications

• Platform: MetaTrader 4
• Language: MQL4
• Trading Timeframe: H1 (recommended)
• Filter Timeframe: D1 (for MTF)
• Currency Pairs: All pairs (user-selectable)
• Account Types: Any MT4 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.