New EA and Indi

2026-01-25 10:34:54 +07:00
parent 39ce46877e
commit 04aa2eb2e6
37 changed files with 17051 additions and 0 deletions
--- a/EA/INPUT_PARAMETERS_REFERENCE.md
+++ b/EA/INPUT_PARAMETERS_REFERENCE.md
@@ -0,0 +1,356 @@
+# Universal Buffer Reader EA - Input Parameters Reference
+
+**Version**: 2.0
+**Date**: 2025-01-20
+
+---
+
+## Quick Reference
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| **General Settings** |
+| `Trade_Mode` | enum | `MODE_INDICATOR` | Trade mode: Indicator or Manual |
+| `LotSize` | double | `0.03` | Fixed lot size (if not using % balance) |
+| `Slippage` | int | `3` | Maximum slippage in points |
+| `MagicNumber` | int | `24680` | Unique identifier for EA trades |
+| `TakeScreenshotOnOpen` | bool | `true` | Capture screenshot when order opens |
+| `EnableDebugPrints` | bool | `true` | Enable debug logging |
+| `ExitOnOppositeSignal` | bool | `false` | Close opposite trades on new signal |
+| **Money Management** |
+| `UsePercentBalanceLot` | bool | `true` | Calculate lot size as % of balance |
+| `PercentOfBalanceForProfit` | double | `1.0` | % of balance for lot calculation |
+| `DailyProfitTargetPercent` | double | `2.0` | Daily profit target as % of balance |
+| **Time Filter** |
+| `EnableTimeFilter` | bool | `true` | Enable time-based trading filter |
+| `TradeSunday` | bool | `false` | Allow trading on Sunday |
+| `TradeMonday` | bool | `true` | Allow trading on Monday |
+| `TradeTuesday` | bool | `true` | Allow trading on Tuesday |
+| `TradeWednesday` | bool | `true` | Allow trading on Wednesday |
+| `TradeThursday` | bool | `true` | Allow trading on Thursday |
+| `TradeFriday` | bool | `true` | Allow trading on Friday |
+| `TradeSaturday` | bool | `false` | Allow trading on Saturday |
+| `AsianSession` | bool | `true` | Allow trading during Asian session |
+| `EuropeSession` | bool | `true` | Allow trading during Europe session |
+| `AmericaSession` | bool | `true` | Allow trading during America session |
+| **Signal Detection** |
+| `IndicatorName` | string | `"Custom Indicator"` | Name of custom indicator |
+| `BuySignalBuffer` | int | `0` | Buffer index for buy signal price |
+| `SellSignalBuffer` | int | `1` | Buffer index for sell signal price |
+| `BuySLBuffer` | int | `2` | Buffer index for buy stop loss |
+| `BuyTP1Buffer` | int | `3` | Buffer index for buy TP1 |
+| `BuyTP2Buffer` | int | `4` | Buffer index for buy TP2 |
+| `BuyTP3Buffer` | int | `5` | Buffer index for buy TP3 |
+| `SellSLBuffer` | int | `6` | Buffer index for sell stop loss |
+| `SellTP1Buffer` | int | `7` | Buffer index for sell TP1 |
+| `SellTP2Buffer` | int | `8` | Buffer index for sell TP2 |
+| `SellTP3Buffer` | int | `9` | Buffer index for sell TP3 |
+| `ATRPeriod` | int | `14` | ATR period for fallback calculation |
+| `ATRMultiple` | double | `1.5` | ATR multiple for SL/TP calculation |
+| `MinTPPips` | int | `20` | Minimum take profit in pips |
+| **Risk Management** |
+| `EnableBreakeven` | bool | `true` | Enable breakeven after profit |
+| `BreakevenPips` | int | `10` | Profit in pips to trigger breakeven |
+| `EnableTPBasedTrailing` | bool | `true` | Enable TP-based trailing stop |
+| `TPBasedTrailingStep` | int | `30` | Pips between TP levels for trailing |
+| `EnableTrailingStop` | bool | `true` | Enable standard trailing stop |
+| `TrailingStopPips` | int | `15` | Trailing stop distance in pips |
+| `TrailingStartPips` | int | `30` | Profit in pips to start trailing |
+| **Partial Close** |
+| `EnablePartialClose` | bool | `true` | Enable partial close at TPs |
+| `UseEqualDivision` | bool | `true` | Divide position equally among TPs |
+| `PartialCloseTP1Percent` | double | `33.33` | % to close at TP1 |
+| `PartialCloseTP2Percent` | double | `33.33` | % to close at TP2 |
+| `PartialCloseTP3Percent` | double | `33.34` | % to close at TP3 |
+
+---
+
+## Detailed Descriptions
+
+### General Settings
+
+#### Trade_Mode
+- **Values**: `MODE_INDICATOR`, `MODE_MANUAL`
+- **Description**: Selects how the EA generates trade signals
+  - `MODE_INDICATOR`: Uses custom indicator buffers for signals
+  - `MODE_MANUAL`: Uses manual buy/sell buttons on chart
+- **Default**: `MODE_INDICATOR`
+
+#### LotSize
+- **Range**: `0.01` to `100.0`
+- **Description**: Fixed lot size used when `UsePercentBalanceLot = false`
+- **Default**: `0.03`
+
+#### Slippage
+- **Range**: `0` to `100`
+- **Description**: Maximum allowed slippage in points when opening orders
+- **Default**: `3`
+
+#### MagicNumber
+- **Range**: `1` to `2147483647`
+- **Description**: Unique identifier to distinguish EA trades from manual trades
+- **Default**: `24680`
+
+#### TakeScreenshotOnOpen
+- **Values**: `true`, `false`
+- **Description**: Captures a screenshot of the chart when a new order is opened
+- **Default**: `true`
+
+#### EnableDebugPrints
+- **Values**: `true`, `false`
+- **Description**: Enables detailed debug logging in Experts tab
+- **Default**: `true`
+
+#### ExitOnOppositeSignal
+- **Values**: `true`, `false`
+- **Description**: Closes existing opposite trades when a new signal is detected
+- **Default**: `false`
+
+---
+
+### Money Management Settings
+
+#### UsePercentBalanceLot
+- **Values**: `true`, `false`
+- **Description**: If true, calculates lot size as percentage of account balance
+- **Default**: `true`
+
+#### PercentOfBalanceForProfit
+- **Range**: `0.1` to `100.0`
+- **Description**: Percentage of account balance to use for lot size calculation
+- **Formula**: `LotSize = (Balance * Percent / 100) / (ContractSize * Price)`
+- **Default**: `1.0`
+
+#### DailyProfitTargetPercent
+- **Range**: `0.1` to `100.0`
+- **Description**: Daily profit target as percentage of account balance
+- **Behavior**: EA stops trading when target is reached, resets next day
+- **Default**: `2.0`
+
+---
+
+### Time Filter Settings
+
+#### EnableTimeFilter
+- **Values**: `true`, `false`
+- **Description**: Enables time-based trading restrictions
+- **Default**: `true`
+
+#### TradeSunday, TradeMonday, ..., TradeSaturday
+- **Values**: `true`, `false`
+- **Description**: Enables trading on specific days of the week
+- **Default**: Mon-Fri enabled, Sat-Sun disabled
+
+#### AsianSession, EuropeSession, AmericaSession
+- **Values**: `true`, `false`
+- **Description**: Enables trading during specific trading sessions
+- **Session Times**:
+  - Asian: 00:00 - 08:00 GMT
+  - Europe: 07:00 - 16:00 GMT
+  - America: 13:00 - 22:00 GMT
+- **Default**: All sessions enabled
+
+---
+
+### Signal Detection Settings
+
+#### IndicatorName
+- **Type**: string
+- **Description**: Name of the custom indicator to use for signals
+- **Requirement**: Indicator must be in `Indicators/` folder
+- **Default**: `"Custom Indicator"`
+
+#### BuySignalBuffer, SellSignalBuffer
+- **Range**: `0` to `7`
+- **Description**: Buffer indices containing buy/sell signal prices
+- **Behavior**: Non-zero value in buffer indicates signal
+- **Default**: `0` (buy), `1` (sell)
+
+#### BuySLBuffer, BuyTP1Buffer, BuyTP2Buffer, BuyTP3Buffer
+- **Range**: `0` to `7`
+- **Description**: Buffer indices containing buy SL/TP levels
+- **Behavior**: If buffer is empty, uses ATR fallback
+- **Default**: `2` (SL), `3` (TP1), `4` (TP2), `5` (TP3)
+
+#### SellSLBuffer, SellTP1Buffer, SellTP2Buffer, SellTP3Buffer
+- **Range**: `0` to `7`
+- **Description**: Buffer indices containing sell SL/TP levels
+- **Behavior**: If buffer is empty, uses ATR fallback
+- **Default**: `6` (SL), `7` (TP1), `8` (TP2), `9` (TP3)
+
+#### ATRPeriod
+- **Range**: `1` to `100`
+- **Description**: Period for ATR indicator (used as fallback)
+- **Default**: `14`
+
+#### ATRMultiple
+- **Range**: `0.5` to `5.0`
+- **Description**: Multiple of ATR to use for SL/TP calculation
+- **Formula**: `SL = EntryPrice ± (ATR * ATRMultiple)`
+- **Default**: `1.5`
+
+#### MinTPPips
+- **Range**: `1` to `1000`
+- **Description**: Minimum take profit distance in pips
+- **Behavior**: Enforces minimum TP even if indicator provides smaller value
+- **Default**: `20`
+
+---
+
+### Risk Management Settings
+
+#### EnableBreakeven
+- **Values**: `true`, `false`
+- **Description**: Moves stop loss to breakeven after specified profit
+- **Default**: `true`
+
+#### BreakevenPips
+- **Range**: `1` to `100`
+- **Description**: Profit in pips required to trigger breakeven
+- **Behavior**: SL moved to open price + spread
+- **Default**: `10`
+
+#### EnableTPBasedTrailing
+- **Values**: `true`, `false`
+- **Description**: Enables trailing stop based on TP levels
+- **Behavior**:
+  - TP1 reached → SL to breakeven
+  - TP2 reached → SL to TP1
+  - TP3 reached → SL to TP2
+- **Default**: `true`
+
+#### TPBasedTrailingStep
+- **Range**: `10` to `100`
+- **Description**: Minimum pips between TP levels for trailing
+- **Default**: `30`
+
+#### EnableTrailingStop
+- **Values**: `true`, `false`
+- **Description**: Enables standard trailing stop after all TPs
+- **Default**: `true`
+
+#### TrailingStopPips
+- **Range**: `1` to `100`
+- **Description**: Distance of trailing stop from current price
+- **Default**: `15`
+
+#### TrailingStartPips
+- **Range**: `1` to `100`
+- **Description**: Minimum profit in pips to start trailing
+- **Default**: `30`
+
+---
+
+### Partial Close Settings
+
+#### EnablePartialClose
+- **Values**: `true`, `false`
+- **Description**: Enables partial position closing at TP levels
+- **Default**: `true`
+
+#### UseEqualDivision
+- **Values**: `true`, `false`
+- **Description**: If true, divides position equally among TPs
+- **Behavior**:
+  - `true`: Uses equal division (33.33%, 33.33%, 33.34%)
+  - `false`: Uses custom percentages
+- **Default**: `true`
+
+#### PartialCloseTP1Percent, PartialCloseTP2Percent, PartialCloseTP3Percent
+- **Range**: `0.01` to `100.0`
+- **Description**: Percentage of position to close at each TP
+- **Requirement**: Sum must equal 100%
+- **Default**: `33.33`, `33.33`, `33.34`
+
+---
+
+## Configuration Examples
+
+### Conservative Configuration
+```
+Trade_Mode = MODE_INDICATOR
+LotSize = 0.01
+UsePercentBalanceLot = false
+EnableBreakeven = true
+BreakevenPips = 15
+EnableTrailingStop = true
+TrailingStopPips = 20
+EnablePartialClose = true
+UseEqualDivision = true
+```
+
+### Aggressive Configuration
+```
+Trade_Mode = MODE_INDICATOR
+LotSize = 0.1
+UsePercentBalanceLot = true
+PercentOfBalanceForProfit = 2.0
+EnableBreakeven = true
+BreakevenPips = 5
+EnableTrailingStop = true
+TrailingStopPips = 10
+EnablePartialClose = true
+UseEqualDivision = false
+PartialCloseTP1Percent = 50.0
+PartialCloseTP2Percent = 30.0
+PartialCloseTP3Percent = 20.0
+```
+
+### Manual Trading Configuration
+```
+Trade_Mode = MODE_MANUAL
+LotSize = 0.05
+EnableTimeFilter = false
+EnableBreakeven = true
+BreakevenPips = 10
+EnableTrailingStop = true
+TrailingStopPips = 15
+EnablePartialClose = true
+UseEqualDivision = true
+```
+
+---
+
+## Troubleshooting
+
+### EA Not Trading
+1. Check `EnableTimeFilter` - ensure current time is allowed
+2. Check `DailyProfitTargetPercent` - ensure target not reached
+3. Check `EnableDebugPrints` - enable to see why trades aren't opening
+4. Check indicator buffers - ensure indicator is providing signals
+
+### Orders Not Opening
+1. Check `LotSize` - ensure within broker limits
+2. Check `Slippage` - increase if orders are rejected
+3. Check `MagicNumber` - ensure unique
+4. Check broker requirements - minimum lot, maximum lot, lot step
+
+### Partial Closes Not Working
+1. Check `EnablePartialClose` - ensure enabled
+2. Check TP levels - ensure price reaches TP levels
+3. Check `UseEqualDivision` - ensure correct setting
+4. Check order comment - ensure TP levels are embedded
+
+### State Not Persisting
+1. Check global variables - ensure not deleted
+2. Check `MagicNumber` - ensure consistent
+3. Check symbol name - ensure correct
+4. Check EA restart - state should survive restart
+
+---
+
+## Best Practices
+
+1. **Always test on demo account first**
+2. **Start with conservative settings**
+3. **Enable debug prints during testing**
+4. **Monitor trades closely in first week**
+5. **Adjust settings based on performance**
+6. **Keep backup of working configuration**
+7. **Document any custom indicator requirements**
+8. **Review logs regularly for errors**
+
+---
+
+**Last Updated**: 2025-01-20
+**Version**: 2.0