## 3. Parameters

This section explains how to configure Zyra Guardian Pro through its input parameters. You do not need to understand every setting to use the EA effectively, but knowing the key groups will help you optimize performance and safety.

### 1. General Settings

- Magic Number: A unique ID used to track positions opened by this EA. Use a different number if running multiple instances.
- Comment: The text label attached to each trade. Useful for sorting or filtering.
- Hide Indicator: If enabled, suppresses visual indicators on the chart.
- Custom Symbol: (Optional) Forces the EA to trade a different symbol than the current chart. Leave empty to use the chart’s symbol.
- Custom Timeframe: (Optional) Runs the EA logic on a different timeframe. For example, run on H1 while attached to an M15 chart. Set to `PERIOD_CURRENT` to use the chart's timeframe.

### 2. Capital Allocation

- Allocation %: Lets you assign only part of your equity to this EA, making multi-EA setups possible.
- Split Factor: Further divides that capital across multiple EAs using the same logic (e.g. 2 EAs with 50% = 25% each).
- RebalancePeriod: Schedules when the allocation refreshes (`Off`, `Weekly`, or `Monthly`). In weekly or monthly mode, the allocated capital is recalculated automatically at the start of each week or month.
- RebalanceHour: Server hour when the rebalance begins. Together with RebalancePeriod, it replays the allocation at the selected time as soon as the new week or month opens.

### 3. Lot Sizing

- Auto Lot Mode: The lot size is calculated based on available capital (e.g. 0.01 per 1000 units).
- Fixed Lot Mode: If chosen, the lot size will remain constant regardless of account size.

### 4. Money Management

- Maximum realised daily loss allowed / Daily profit target: daily thresholds expressed as a percentage of capital. Combined with Calculation mode for the daily PnL and Close all positions when the daily limit is reached, they dictate whether the EA pauses or liquidates trades when limits are met.
- Maximum realised weekly loss allowed / Weekly profit target: the weekly counterparts that extend protection to the full trading week. Their behaviour depends on Calculation mode for the weekly PnL (Balance vs Equity) and the Close all positions when the weekly limit is reached safeguard.
- Action to apply when exiting a user-defined session: defines the reaction (Close, Pause, Continue) when any daily or weekly limit is hit. See the Protection page for detailed interactions.

### 5. Risk Controls

- Max Spread: Prevents trades if the current spread is above a defined threshold (in points).
- Max Trades: Limits the number of simultaneous open trades (0 = no limit).
- Stop if Equity Below: The EA halts if account equity drops below this level.

### 6. Take Profit & Trailing

Take Profit Type defines the global target applied to the basket of positions. Selecting `TPTrailing` enables a dynamic take profit that relies on the parameters below. The other modes (fixed in currency or percentage) fully disable trailing.

- ChoseTrailingMode: Selects how trailing thresholds are calculated between two approaches:
  - `TrailingByPercent`: the trigger (`TrailingStartPct`) and distance (`TrailingDistancePct`) are expressed as a percentage of the allocated capital.
  - `TrailingPerLot`: the trigger (`TrailingStartPerLot`) and distance (`TrailingDistancePerLot`) are converted to absolute values per 0.01 lot traded.
- TrailingStart…: regardless of the mode, this value defines the profit level required to arm the trailing logic. With `TrailingByPercent`, the threshold is a percentage of capital; with `TrailingPerLot`, it scales directly with the total lot size of the basket.
- TrailingDistance…: once trailing is active, this value tightens the take profit at the defined distance. In percentage mode the distance remains proportional to capital, while the per-lot mode applies a currency value recalculated for each 0.01 lot.

Usage note: in `TrailingPerLot` mode, Zyra converts floating profit into a per-0.01-lot value to decide when to trigger and tighten the trailing. For example, with 0.23 lots open and `TrailingStartPerLot = 8.0`, the EA waits for roughly `0.23 / 0.01 = 23` increments, or `23 × 8 = 184` currency units, before activating trailing, then applies the same conversion to maintain the trailing distance.

### 7. Global Stop Loss

- Stop Loss Mode: You can choose between:
  - `SLPourcent`: Closes all trades if floating loss reaches X% of allocated capital.
  - `SLByLot`: Closes all trades if the floating loss reaches the equivalent of a fixed $ value per 0.01 lot (e.g., $100).
- Global Stop %: Only used if `SLPourcent` is selected. When losses exceed this percentage, all trades are closed.
- SL per 0.01 Lot ($): Used only if `SLByLot` is selected. For example, if set to $100, Zyra will close the cycle when floating losses hit $100 per 0.01 lot open.

### 8. Grid Logic

- Step: The minimum distance in points between each level in the grid.
- Lot Multiplier: The multiplication factor for each new trade in the grid sequence.
- Positive Grid: Only adds new positions if the previous one is already in profit.
- Single Direction: Enables one-way grids (either buy or sell at a time).
- Number of bars to wait after a full grid close before opening new positions: sets how many bars the EA must wait after a full cycle is closed before new entries are allowed. While the countdown is active, the panel shows "Post-close cooldown: waiting" with the remaining bars; once the delay expires, the status switches back to "Post-close cooldown: inactive".

### 9. Entry & Scoring

- Score Threshold: Defines the number of positive signals required to trigger an entry.
- Signal Toggles: You can enable/disable each of the 30+ technical signals individually.
- For full details, see the Indicators section.

### 10. Consensus Window

The consensus engine aggregates individual indicator votes into a time window before the EA authorizes a trade. These parameters help you control how decisive and reactive that window should be.

- Size of the window (≥1 closed bar): number of bars stored inside the rolling window. A higher value smooths out noisy spikes but delays reactions to sudden reversals, while a smaller value makes the consensus faster and more sensitive to fresh signals.
- Weight scores by recency: when enabled, the most recent bars contribute more to the final score. Bias shifts become more responsive at the cost of giving less weight to older confirmations.
- Decay factor (decay^age): multiplier applied when recency weighting is active. Values close to 1 keep a gentle decay, whereas smaller values quickly fade out older signals.
- Neutralize conflicting indicators within the window: cancels out opposite readings from the same indicator so that alternating spikes do not produce false positives.
- Compute using closed bars only: forces the engine to wait for fully closed candles before recomputing the consensus, removing intrabar flicker in exchange for extra stability.
- Minimum cooldown between new entries: enforces a delay (in bars) between two identical consensus decisions. This cooldown blocks rapid-fire orders until the window progresses.
- Maximum number of entries per sliding window: caps how many new trades may be validated within the same window span. Once the quota is met, extra orders are denied until the buffer advances, acting as a brake during volatility bursts.
- Reset when a major indicator strongly contradicts the signal: flushes the current consensus memory as soon as a major indicator prints the opposite bias. The EA then waits for a fresh round of confirmations before authorising another entry.
- Major indicator toggles: the switches Treat Ichimoku as a major indicator, …MACD…, …ADX…, …RSI…, and …Bollinger Bands… decide which sources can trigger that reset. Only the indicators enabled here receive veto power over the consensus.

Tip: Monitor the log entries labelled `CW[W]` and `CW[M]` (see Strategy page) to verify how the window reacts to your configuration tweaks.

### 11. Indicator Parameters

Each indicator has its own internal configuration (periods, thresholds, confirmation logic, etc.). You can fine-tune them to match your preferred strategy. See the Indicators page for complete breakdowns.

### 11. Trading Session Management

The setting Action to apply when exiting a user-defined session defines how the EA reacts when daily or weekly limits are reached. It can stay in Continue mode (no closure, only new entries are blocked), switch to Pause (full suspension of new trades), or force a Close (immediate liquidation of every open position).

The TradeMonday…TradeSunday parameters enable or disable trading for each day of the week. Each input accepts a list of time windows formatted as `HH:MM-HH:MM;` — for example, `08:00-11:30;13:30-17:00;`. Every window must end with a semicolon, and you can chain as many as needed to cover the sessions you want to allow. Leaving the field empty authorizes trading throughout the entire day.

The safeguard Close all positions after the last session on Friday automatically liquidates every trade at the end of the final Friday session. After the flattening, the grid is reset for the weekend and the panel first reports "Weekly flat: executed on…", then "Weekly flat: inactive" while the protection remains armed for the new week.

### Next Step

Continue to the Strategy section to learn how signals are combined and how the grid system operates.