356 lines
12 KiB
Markdown
356 lines
12 KiB
Markdown
# 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 |