# Robot de Trading de Oro (Premium) - Descripción del Mercado

## Resumen del Producto

Gold Trading Robot (Premium) es un cBot de tendencia de un solo motor para **XAUUSD** en **M15**.

Está diseñado para mantener la lógica de ejecución robusta y comprensible, permitiendo al mismo tiempo una optimización profunda mediante parámetros agrupados.

Objetivos principales de diseño:

- Operar solo configuraciones confirmadas de barras cerradas (sin decisiones de entrada tipo repaint).

- Usar un modelo de señal claro (cruce de EMA + contexto ATR) en lugar de apilar muchos filtros estrictos.

- Mantener una gestión estricta y sistemática del riesgo y la posición (tamaño de riesgo de capital, lógica de stop basada en ATR, protecciones contra drawdown).

- Mantener un comportamiento protector de nivel de producción para spread, drawdown diario/total, pérdidas consecutivas, enfriamiento y exposición a gaps de fin de semana.

## Cómo Funciona el Robot

### 1) Alcance de Mercado y Marco Temporal

- La estrategia está destinada para la operación en **XAUUSD, M15**.

- El cálculo de la señal se basa en barras M15 cerradas, evitando decisiones en velas incompletas.

### 2) Motor de Señales

- Disparador de dirección: **cruce EMA rápido / EMA lento**.

- Contexto de volatilidad: **ATR de Wilder**.

- Modelo de calidad: un sistema de **puntuación 0-4** (en lugar de muchos filtros obligatorios).

- Contexto opcional de marco temporal superior: **filtro de tendencia H1**.

Una señal se considera solo si existe un cruce y se alcanza la puntuación mínima de calidad.

### 3) Gestión de Riesgo y Ejecución de Órdenes

- El tamaño de la posición se basa en **% de riesgo de capital por operación**.

- El stop inicial se calcula como un **múltiplo de ATR**.

- La entrada se bloquea si el spread actual está por encima del spread máximo configurado.

- El volumen se normaliza de forma conservadora (a la baja) para evitar arriesgar por encima del objetivo.

### 4) Gestión de Posiciones

- No se requiere un TP fijo según la lógica del motor; las salidas se gestionan mediante:

- **disparador de break-even** (en espacio de múltiplos R).

- **stop trailing ATR**.

- Las actualizaciones del stop solo se mueven en dirección favorable e incluyen control anti-ruido.

### 5) Capa de Protección

- Las pérdidas consecutivas máximas pueden activar un enfriamiento.

- El bloqueo por drawdown diario bloquea más entradas durante el día.

- El bloqueo por drawdown total bloquea entradas hasta el reinicio (comportamiento de bloqueo de seguridad).

- La protección de viernes/fin de semana puede bloquear entradas o cerrar posiciones antes del gap del fin de semana.

## Parámetros Por Grupo

### Motor de Señales

- **Periodo EMA Rápida**: Periodo para la EMA rápida usada en la detección del cruce de dirección.

- **Periodo EMA Lenta**: Periodo para la EMA lenta usada como referencia de tendencia base.

- **Periodo ATR**: ATR de Wilder para contexto de volatilidad y cálculos de distancia de stop.

- **Puntuación Mínima de Señal (1-4)**: Puntuación mínima de calidad requerida antes de que se pueda operar un cruce.

- **Usar Filtro de Tendencia H1**: Habilita/deshabilita la confirmación de tendencia en marco temporal superior.

- **Cuerpo Mínimo de Vela (x ATR)**: Tamaño mínimo del cuerpo de la vela como fracción de ATR para la puntuación de calidad.

- **Separación Mínima MA (x ATR)**: Separación mínima entre EMA rápida/lenta como fracción de ATR para la puntuación de calidad.

### Gestión de Riesgo

- **Porcentaje de Riesgo por Operación (% de Capital)**: Porcentaje objetivo de capital arriesgado en cada nueva operación.

- **Stop Loss Inicial (x ATR)**: Distancia inicial del stop desde la entrada como múltiplo de ATR.

- **Buffer de Costos de Ejecución (pips)**: Buffer adicional de seguridad para incertidumbre de spread/transacción en el dimensionamiento del riesgo.

- **Spread Máximo (pips)**: Umbral duro de spread por encima del cual no se abre una nueva orden.

### Trailing / Break-Even

- **Trailing Stop (x ATR)**: Múltiplo de ATR usado para seguir el stop mientras la operación está en ganancia.

- **Disparador Break-Even (x R)**: Umbral de ganancia (en R) donde el stop se mueve a la zona lógica de break-even.

- **Desplazamiento Break-Even (pips)**: Desplazamiento extra en pips al aplicar break-even para evitar un stop demasiado ajustado en la entrada exacta.

### Protección

- **Filtro ATR Máximo (pips, 0 = desactivado)**: Límite opcional de volatilidad; si el ATR está por encima de este, se omiten las entradas.

- **Pérdidas Consecutivas Máximas**: Número de operaciones perdedoras permitidas antes de activar la protección de enfriamiento.

- **Enfriamiento (barras M15)**: Número de barras M15 para esperar tras la activación del enfriamiento por racha de pérdidas.

- **Límite de Drawdown Diario (%)**: Umbral de drawdown diario de capital para bloquear más entradas.

- **Límite de Drawdown Total (%)**: Umbral de drawdown de sesión/global para activar un bloqueo de seguridad de larga duración.

- **Modo de Protección de Viernes**: Modo de comportamiento para gaps de fin de semana (apagado / bloquear entradas / cerrar posiciones).

## Notas Operativas Para Usuarios del Mercado

- Los mejores resultados deben validarse con **pruebas fuera de muestra** y **pruebas hacia adelante**.

- Para XAUUSD, siempre verifique la escala del símbolo y las condiciones del broker (spread, comportamiento de sesión, calidad de ejecución).

- Se recomienda una optimización conservadora en lugar de un ajuste extremo de parámetros.

## Para Quién Es Este Robot

- Traders que desean un motor de tendencia transparente con controles de riesgo fuertes.

- Usuarios que prefieren control parametrizado tanto sobre la estricta señal como sobre el comportamiento de seguridad.

- Usuarios sistemáticos que pueden realizar validaciones robustas (en muestra, fuera de muestra, hacia adelante) antes del despliegue en vivo.