# 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.