الوصف
# Gold Trading Robot (Premium) - Marketplace Description
## Product Overview
Gold Trading Robot (Premium) is a single-engine trend-following cBot for **XAUUSD** on **M15**.
It is designed to keep execution logic robust and understandable while still allowing deep optimization through grouped parameters.
Core design goals:
- Trade only confirmed setups from closed bars (no repaint-style entry decisions).
- Use one clear signal model (EMA crossover + ATR context) instead of stacking many hard filters.
- Keep risk and position management strict and systematic (equity risk sizing, ATR-based stop logic, drawdown guards).
- Maintain production-grade protective behavior for spread, daily/total drawdown, consecutive losses, cooldown, and weekend gap exposure.
## How The Robot Works
### 1) Market and Timeframe Scope
- The strategy is intended for **XAUUSD, M15** operation.
- Signal calculation is based on closed M15 bars, avoiding decisions on incomplete candles.
### 2) Signal Engine
- Direction trigger: **EMA fast / EMA slow crossover**.
- Volatility context: **Wilder ATR**.
- Quality model: a **0-4 score** system (instead of many mandatory filters).
- Optional higher-timeframe context: **H1 trend filter**.
A signal is considered only if crossover exists and minimum quality score is reached.
### 3) Risk and Order Execution
- Position sizing is based on **% of equity risk per trade**.
- Initial stop is computed as an **ATR multiple**.
- Entry is blocked if current spread is above configured max spread.
- Volume is normalized conservatively (downward) to avoid risking above target.
### 4) Position Management
- No fixed TP is required by the engine logic; exits are managed by:
- **Break-even trigger** (in R-multiple space).
- **ATR trailing stop**.
- Stop updates move only in favorable direction and include anti-noise update control.
### 5) Protection Layer
- Max consecutive losses can trigger cooldown.
- Daily drawdown lock blocks further entries for the day.
- Total drawdown lock blocks entries until restart (safety lock behavior).
- Friday/weekend protection can block entries or close positions before weekend gap.
## Parameters By Group
### Signal Engine
- **Fast EMA Period**: Period for the fast EMA used in crossover direction detection.
- **Slow EMA Period**: Period for the slow EMA used as the baseline trend reference.
- **ATR Period**: Wilder ATR lookback used for volatility context and stop-distance calculations.
- **Minimum Signal Score (1-4)**: Required minimum quality score before a crossover can be traded.
- **Use H1 Trend Filter**: Enables/disables higher-timeframe trend confirmation.
- **Min Candle Body (x ATR)**: Minimum candle body size as ATR fraction for quality scoring.
- **Min MA Separation (x ATR)**: Minimum fast/slow EMA separation as ATR fraction for quality scoring.
### Risk Management
- **Risk Percent per Trade (% Equity)**: Target percentage of equity risked on each new trade.
- **Initial Stop Loss (x ATR)**: Initial stop distance from entry as ATR multiple.
- **Execution Cost Buffer (pips)**: Additional safety buffer for spread/transaction uncertainty in risk sizing.
- **Max Spread (pips)**: Hard spread threshold above which no new order is opened.
### Trail / Break-Even
- **Trailing Stop (x ATR)**: ATR multiple used to trail stop while trade moves in profit.
- **Break-Even Trigger (x R)**: Profit threshold (in R) where stop moves to break-even logic zone.
- **Break-Even Offset (pips)**: Extra pip offset when applying break-even to avoid too-tight stop at exact entry.
### Protection
- **Max ATR Filter (pips, 0 = disabled)**: Optional volatility cap; if ATR is above this, entries are skipped.
- **Max Consecutive Losses**: Number of losing trades allowed before cooldown protection triggers.
- **Cooldown (M15 bars)**: Number of M15 bars to wait after loss-streak cooldown activation.
- **Daily Drawdown Limit (%)**: Daily equity drawdown threshold to block further entries.
- **Total Drawdown Limit (%)**: Session/global drawdown threshold to activate long-duration safety lock.
- **Friday Protection Mode**: Weekend-gap behavior mode (off / block entries / close positions).
## Operational Notes For Marketplace Users
- Best results should be validated with **out-of-sample** and **forward testing**.
- For XAUUSD, always verify symbol scale and broker conditions (spread, session behavior, execution quality).
- Conservative optimization is recommended over extreme parameter edge fitting.
## Who This Robot Is For
- Traders who want a transparent trend engine with strong risk controls.
- Users who prefer parameterized control over both signal strictness and safety behavior.
- Systematic users who can perform robust validation (in-sample, OOS, forward) before live deployment.
