# 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