# Robô de Negociação de Ouro (Premium) - Descrição do Mercado

## Visão Geral do Produto

Robô de Negociação de Ouro (Premium) é um cBot de tendência com motor único para **XAUUSD** no **M15**.

Foi projetado para manter a lógica de execução robusta e compreensível, permitindo ainda uma otimização profunda por meio de parâmetros agrupados.

Objetivos principais do design:

- Negociar apenas configurações confirmadas de barras fechadas (sem decisões de entrada do tipo repaint).

- Usar um modelo de sinal claro (cruzamento de EMA + contexto ATR) em vez de empilhar muitos filtros rígidos.

- Manter o gerenciamento de risco e posição estrito e sistemático (dimensionamento de risco de patrimônio, lógica de stop baseada em ATR, proteções contra drawdown).

- Manter comportamento protetor de nível de produção para spread, drawdown diário/total, perdas consecutivas, cooldown e exposição a gaps de fim de semana.

## Como o Robô Funciona

### 1) Escopo de Mercado e Prazo

- A estratégia é destinada para operação em **XAUUSD, M15**.

- O cálculo do sinal é baseado em barras M15 fechadas, evitando decisões em velas incompletas.

### 2) Motor de Sinal

- Gatilho de direção: **cruzamento EMA rápido / EMA lento**.

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

- Modelo de qualidade: um sistema de **pontuação 0-4** (em vez de muitos filtros obrigatórios).

- Contexto opcional de timeframe superior: **filtro de tendência H1**.

Um sinal é considerado apenas se existir cruzamento e a pontuação mínima de qualidade for atingida.

### 3) Risco e Execução de Ordem

- O dimensionamento da posição é baseado em **% do risco de patrimônio por negociação**.

- O stop inicial é calculado como um **múltiplo do ATR**.

- A entrada é bloqueada se o spread atual estiver acima do spread máximo configurado.

- O volume é normalizado de forma conservadora (para baixo) para evitar risco acima do alvo.

### 4) Gerenciamento de Posição

- Nenhum TP fixo é exigido pela lógica do motor; as saídas são gerenciadas por:

- **gatilho de break-even** (em espaço de múltiplo R).

- **stop móvel ATR**.

- Atualizações de stop movem-se apenas na direção favorável e incluem controle anti-ruído.

### 5) Camada de Proteção

- Perdas consecutivas máximas podem ativar cooldown.

- Bloqueio de drawdown diário impede novas entradas no dia.

- Bloqueio de drawdown total impede entradas até reinício (comportamento de bloqueio de segurança).

- Proteção de sexta-feira/fim de semana pode bloquear entradas ou fechar posições antes do gap de fim de semana.

## Parâmetros Por Grupo

### Motor de Sinal

- **Período EMA Rápida**: Período para a EMA rápida usada na detecção de direção por cruzamento.

- **Período EMA Lenta**: Período para a EMA lenta usada como referência de tendência base.

- **Período ATR**: Wilder ATR usado para contexto de volatilidade e cálculos de distância de stop.

- **Pontuação Mínima de Sinal (1-4)**: Pontuação mínima de qualidade exigida antes que um cruzamento possa ser negociado.

- **Usar Filtro de Tendência H1**: Ativa/desativa confirmação de tendência em timeframe superior.

- **Corpo Mínimo da Vela (x ATR)**: Tamanho mínimo do corpo da vela como fração do ATR para pontuação de qualidade.

- **Separação Mínima MA (x ATR)**: Separação mínima entre EMA rápida/lenta como fração do ATR para pontuação de qualidade.

### Gerenciamento de Risco

- **Percentual de Risco por Negociação (% do Patrimônio)**: Percentual alvo do patrimônio arriscado em cada nova negociação.

- **Stop Loss Inicial (x ATR)**: Distância inicial do stop a partir da entrada como múltiplo do ATR.

- **Buffer de Custo de Execução (pips)**: Buffer adicional de segurança para incertezas de spread/transação no dimensionamento de risco.

- **Spread Máximo (pips)**: Limite rígido de spread acima do qual nenhuma nova ordem é aberta.

### Trailing / Break-Even

- **Stop Móvel (x ATR)**: Múltiplo do ATR usado para mover o stop enquanto a negociação está em lucro.

- **Gatilho Break-Even (x R)**: Limite de lucro (em R) onde o stop se move para a zona de lógica break-even.

- **Offset Break-Even (pips)**: Offset extra em pips ao aplicar break-even para evitar stop muito apertado na entrada exata.

### Proteção

- **Filtro Máximo ATR (pips, 0 = desativado)**: Limite opcional de volatilidade; se o ATR estiver acima deste, as entradas são puladas.

- **Máximo de Perdas Consecutivas**: Número de negociações perdedoras permitidas antes da ativação da proteção cooldown.

- **Cooldown (barras M15)**: Número de barras M15 para aguardar após ativação do cooldown por sequência de perdas.

- **Limite de Drawdown Diário (%)**: Limite de drawdown diário do patrimônio para bloquear novas entradas.

- **Limite de Drawdown Total (%)**: Limite de drawdown da sessão/global para ativar bloqueio de segurança de longa duração.

- **Modo de Proteção de Sexta-feira**: Modo de comportamento para gap de fim de semana (desligado / bloquear entradas / fechar posições).

## Notas Operacionais Para Usuários do Mercado

- Os melhores resultados devem ser validados com **teste fora da amostra** e **teste forward**.

- Para XAUUSD, sempre verifique a escala do símbolo e as condições do corretor (spread, comportamento da sessão, qualidade de execução).

- Recomenda-se otimização conservadora em vez de ajuste extremo de parâmetros.

## Para Quem Este Robô É Destinado

- Traders que desejam um motor de tendência transparente com controles de risco fortes.

- Usuários que preferem controle parametrizado tanto sobre a rigidez do sinal quanto sobre o comportamento de segurança.

- Usuários sistemáticos que podem realizar validação robusta (in-sample, OOS, forward) antes da implantação ao vivo.