╔══════════════════════════════════════════════════════════════╗

║ AI US500 PRO ║

║ cBot híbrido de tendência / reversão à média ║

║ Multi-AI • Multi-Intervalo de Tempo ║

╚══════════════════════════════════════════════════════════════╝

🧠 **AI US500 PRO** é um cBot profissional para cTrader especificamente projetado para o índice S&P 500 (US500). Ele combina análise técnica multi-intervalo de tempo com inteligência artificial para filtrar cada operação antes da execução.

O bot opera em **3 intervalos de tempo simultâneos** (H4 → H1 → M15), detecta automaticamente o regime de mercado (tendência ou lateral) e aplica a estratégia mais adequada: seguir a tendência quando o mercado tem direção, reversão à média quando está se movendo lateralmente. Cada sinal gerado pode ser validado em tempo real por um modelo de IA de sua escolha entre **13 provedores suportados**.

Funciona com `AccessRights.None` — não requer permissões especiais, usa as APIs HTTP nativas do cTrader.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📐 **ARQUITETURA DA ESTRATÉGIA**

O bot segue um fluxo de decisão em cascata:

```

H4 (EMA 200) → Determina a tendência direcional de longo prazo (altista / baixista / neutra)

↓

H1 (EMA 50 + RSI 14) → Confirma a direção e avalia o excesso

↓

M15 (EMA 21/50 + Stoch + BB + ADX + ATR) → Gera o sinal de entrada

↓

IA (Claude / GPT / Gemini / ...) → Filtra o sinal com uma pontuação de confiança

↓

Execução → Cálculo de volume, SL/TP dinâmicos, trailing stop

```

⚡ **Detecção de Regime (ADX)**

— ADX ≥ limite → mercado em tendência → estratégia de seguir a tendência

— ADX < limite → mercado lateral → estratégia de reversão à média

A troca é totalmente automática, barra a barra.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📊 **ESTRATÉGIA DE SEGUIR A TENDÊNCIA**

Condições de entrada LONG:

✅ H4: preço acima da EMA 200 (viés altista)

✅ H1: preço acima da EMA 50 + RSI > 50

✅ M15: EMA 21 cruza acima da EMA 50 (cruzamento altista)

✅ M15: Stochastic K cruza acima de D, com K < 65 (não sobrecomprado)

Condições de entrada SHORT: espelhadas e invertidas.

📊 **ESTRATÉGIA DE REVERSÃO À MÉDIA**

Condições de entrada LONG:

✅ ADX abaixo do limite (mercado lateral)

✅ M15: preço toca ou rompe a Banda de Bollinger inferior

✅ M15: Stochastic K < 20 (sobrevendido)

✅ H1: RSI < 35 (excesso baixista)

Condições de entrada SHORT: espelhadas e invertidas.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🤖 **INTEGRAÇÃO DE IA — 13 PROVEDORES**

Quando o bot gera um sinal técnico válido, antes de executá-lo envia à IA um pacote completo de dados contendo:

— Todos os indicadores multi-intervalo de tempo

— As últimas N velas M15 (OHLCV)

— Direção proposta e estratégia ativa

— Parâmetros de risco (SL/TP em pips, razão R:R)

— Status da conta e posições abertas

A IA responde com:

— **Pontuação de confiança** (0-100%)

— **Decisão** (IR / NÃO_IR)

— **Fatores chave** (2-3 fatores principais)

— **Aviso de risco** (principal risco identificado)

Se a confiança ficar abaixo do limite mínimo, a operação é **bloqueada**.

Após cada operação ser encerrada, a IA também fornece uma **análise pós-operação** com avaliação, classificação e lição aprendida.

**Provedores suportados:**

```

1. Anthropic (Claude) — claude-sonnet-4

2. OpenAI (ChatGPT) — gpt-4o

3. Google (Gemini) — gemini-2.0-flash

4. Mistral — mistral-large-latest

5. Groq — llama-3.3-70b-versatile

6. Perplexity — sonar-pro

7. Cohere — command-r-plus

8. xAI (Grok) — grok-2

9. DeepSeek — deepseek-chat

10. Together AI — Llama-3.3-70B-Instruct-Turbo

11. Fireworks AI — llama-v3p3-70b-instruct

12. OpenRouter — anthropic/claude-sonnet-4

13. Ollama (local, grátis) — llama3.1

```

Cada provedor tem uma URL e modelo padrão pré-configurados. Você pode substituir tanto o modelo quanto a URL para máxima flexibilidade.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🔧 **PARÂMETROS — GUIA COMPLETO**

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

💰 **1. GERENCIAMENTO DE RISCO**

▸ **Modo de Risco** — `PercentRisk` / `FixedLot`

Escolha entre dimensionamento de posição baseado em porcentagem ou lote fixo. No modo PercentRisk o bot calcula automaticamente o volume com base na distância do stop loss e capital disponível. Padrão: `PercentRisk`

▸ **% de Risco por Operação** — 0,1% a 5,0%

Porcentagem do saldo da conta arriscada em cada operação. O volume é calculado para que, se o SL for atingido, a perda seja exatamente essa porcentagem. Padrão: `1,0%`

▸ **Volume Fixo (Lotes)** — 0,01 e acima

Volume fixo em lotes, usado apenas quando o Modo de Risco está definido como FixedLot. Padrão: `0,1`

▸ **Máximo de Posições Abertas** — 1 a 10

Número máximo de posições que o bot pode manter simultaneamente. Quando o limite é atingido, nenhuma nova operação é aberta. Padrão: `3`

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📈 **2. VIÉS DE TENDÊNCIA H4**

▸ **Período EMA H4** — 50 e acima

Período da EMA aplicado ao intervalo de tempo H4. Determina o viés direcional de longo prazo. Preço acima da EMA = viés altista, abaixo = baixista. Um buffer baseado em ATR previne sinais falsos quando o preço está muito próximo da média. Padrão: `200`

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🔍 **3. CONFIRMAÇÃO H1**

▸ **Período EMA H1** — 10 e acima

Período da EMA no intervalo de tempo H1. O preço deve estar do lado correto desta EMA para confirmar a entrada. Padrão: `50`

▸ **Período RSI H1** — 5 e acima

Período do Índice de Força Relativa no H1. Usado tanto para confirmação de tendência (RSI > 50 para longs, < 50 para shorts) quanto para filtragem de excesso na reversão à média (RSI < 35 ou > 65). Padrão: `14`

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🎯 **4. ENTRADA M15**

▸ **Período EMA Rápida** — 5 e acima

EMA rápida no intervalo de entrada (M15). O cruzamento com a EMA lenta gera o sinal de seguir a tendência. Padrão: `21`

▸ **Período EMA Lenta** — 10 e acima

EMA lenta. O cruzamento EMA rápida/lenta é o gatilho principal para a estratégia de tendência. Padrão: `50`

▸ **Stochastic K / D / Slowing** — períodos do oscilador estocástico

Usado como confirmação de momentum. Na estratégia de tendência filtra entradas em zonas não extremas; na reversão à média identifica áreas de sobrecompra/sobrevenda. Padrão: `K=14, D=3, Slowing=3`

▸ **Período Bollinger** — 10 e acima

Período das Bandas de Bollinger. Na reversão à média, o toque da banda superior/inferior é o gatilho de entrada. Padrão: `20`

▸ **Desvio Padrão Bollinger** — 1,0 e acima

Desvio padrão das bandas. Valores maiores = bandas mais largas = menos sinais, porém mais confiáveis. Padrão: `2,0`

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🌡️ **5. DETECÇÃO DE REGIME (ADX)**

▸ **Período ADX** — 7 e acima

Período do Sistema de Movimento Direcional. Mede a força da tendência independentemente da direção. Padrão: `14`

▸ **Limite de Tendência ADX** — 15 a 40

Limite que separa mercados em tendência de mercados laterais. ADX acima deste valor = seguir a tendência ativo; abaixo = reversão à média ativo. Padrão: `25`

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🛡️ **6. SL / TP (BASEADO EM ATR)**

Todos os stops e take profits são dinâmicos, calculados como múltiplos do ATR atual. Isso significa que eles se adaptam automaticamente à volatilidade: stops apertados em mercados calmos, stops mais largos em mercados voláteis.

▸ **Período ATR** — 5 e acima

Período do Average True Range. Mede a volatilidade recente e serve como base para cálculos de SL, TP, breakeven e trailing. Padrão: `14`

▸ **SL x ATR** — 0,5 e acima

Multiplicador ATR para stop loss. Ex.: com ATR = 20 pontos e multiplicador 1,5, o SL será 30 pontos do preço de entrada. Padrão: `1,5`

▸ **TP x ATR (Tendência)** — 1,0 e acima

Multiplicador ATR para take profit na estratégia de seguir a tendência. Normalmente maior que o SL para uma razão R:R favorável. Padrão: `2,5`

▸ **TP x ATR (Reversão)** — 0,5 e acima

Multiplicador ATR para take profit na estratégia de reversão à média. Normalmente mais conservador pois o alvo é o retorno à média. Padrão: `1,5`

▸ **SL mínimo (Pips)** — 1 e acima

Stop loss mínimo em pips. Se o cálculo do ATR produzir um SL abaixo deste valor, o mínimo é usado. Protege contra stops excessivamente apertados em condições de volatilidade ultra baixa. Padrão: `10`

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🔄 **7. TRAILING STOP**

Sistema de gerenciamento ativo para posições abertas com breakeven automático e trailing stop, ambos baseados em ATR.

▸ **Ativar Trailing** — Ligado/Desligado

Ativa/desativa todo o sistema de trailing. Quando desligado, as posições mantêm seus SL/TP fixos até o fechamento. Padrão: `Ligado`

▸ **Breakeven Após x ATR** — 0,3 e acima

Quando o lucro não realizado atinge este múltiplo do ATR, o SL é movido para o preço de entrada (+ metade do spread para cobrir custos). A operação torna-se sem risco. Padrão: `1,0`

▸ **Distância do Trailing x ATR** — 0,5 e acima

Distância do trailing stop a partir do preço atual, expressa como múltiplo do ATR. O SL segue o preço e nunca retrocede. Padrão: `1,2`

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🕐 **8. FILTRO DE SESSÃO**

Filtra a atividade de negociação com base no horário. O US500 se comporta de forma muito diferente durante o pré-mercado, sessão regular e after-hours.

▸ **Ativar Filtro de Sessão** — Ligado/Desligado

Ativa/desativa o filtro de tempo. Padrão: `Ligado`

▸ **Início da Sessão (Hora CET)** — 0-23

Hora de início da janela de negociação (fuso CET). Padrão: `15` (abertura da sessão dos EUA)

▸ **Fim da Sessão (Hora CET)** — 0-23

Hora de término da janela de negociação. Padrão: `22` (fechamento da sessão dos EUA)

O bot também suporta sessões que cruzam a meia-noite (ex.: Início=22, Fim=6).

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

⚙️ **9. DIVERSOS**

▸ **Cooldown (Barras)** — 0 e acima

Número mínimo de barras M15 que devem passar entre uma operação e a próxima. Evita overtrading em situações de sinais rápidos. Padrão: `3` (= 45 minutos)

▸ **Mostrar Painel** — Ligado/Desligado

Mostra/oculta o painel no gráfico com regime, viés, indicadores, P&L, status da IA e estatísticas ao vivo. Padrão: `Ligado`

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🤖 **10. ANÁLISE DE IA**

▸ **Ativar Filtro de IA** — Ligado/Desligado

Ativa/desativa o filtro de IA. Quando desligado, o bot opera apenas com análise técnica. Padrão: `Desligado`

▸ **Provedor de IA** — seleção entre 13 provedores

Escolha qual provedor de IA usar. Cada provedor tem uma URL e modelo padrão pré-configurados. Padrão: `Anthropic`

▸ **Chave API** — string

Sua chave API para o provedor selecionado. Obrigatória para todos os provedores exceto Ollama (que roda localmente). Deixe em branco se usar Ollama.

▸ **Modelo (em branco = padrão)** — string

Substituição do modelo de IA. Deixe em branco para usar o modelo padrão do provedor selecionado. Útil para testar modelos específicos (ex.: "gpt-4o-mini", "claude-haiku-4-5-20251001").

▸ **URL API personalizada (em branco = padrão)** — string

Substituição da URL da API. Útil para Ollama em porta customizada, proxies corporativos ou endpoints personalizados.

▸ **Confiança mínima (%)** — 30 a 95

Limite mínimo de confiança da IA para aprovar uma operação. Se a IA retornar uma pontuação abaixo disso, a operação é bloqueada mesmo que todos os sinais técnicos sejam válidos. Padrão: `65`

▸ **Falha Aberta (permitir em erro)** — Ligado/Desligado

Comportamento quando a IA falha (timeout, API fora, resposta malformada). Ligado = a operação é executada mesmo assim (fail-open). Desligado = operação é bloqueada (fail-closed). Padrão: `Ligado`

▸ **Revisão de IA Pós-Operação** — Ligado/Desligado

Quando ativado, após cada operação ser encerrada o bot envia os detalhes do resultado para a IA, que fornece uma avaliação, classificação (BOM/NEUTRO/RUIM) e lição aprendida. Tudo é registrado no console. Padrão: `Ligado`

▸ **Velas para IA** — 5 a 25

Número de velas M15 recentes enviadas para a IA no contexto da análise. Mais barras = mais contexto, mas mais tokens consumidos. Padrão: `12`

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📋 **PAINEL NO GRÁFICO**

O painel exibe em tempo real:

— Regime atual (TENDÊNCIA / LATERAL)

— Viés H4 (ALTISTA / BAIXISTA / NEUTRO)

— Valores de ADX, ATR, RSI H1

— Posições abertas / máximo

— P&L aberto, saldo, patrimônio

— Status da sessão (ATIVA / FECHADA)

— Total de operações e % de acerto

— Status da IA: provedor, última decisão, confiança

— Contagem de chamadas da IA e operações bloqueadas

A cor muda automaticamente: 🟢 verde quando o P&L é positivo, 🔴 vermelho quando negativo.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📌 **NOTAS TÉCNICAS**

— Intervalo de tempo recomendado: **M15** (o bot avisa se usado em outros TFs)

— `AccessRights.None` — não requer permissões especiais

— Usa `Http.Send()` nativo do cTrader para chamadas de IA

— Compatível com cTrader 4.2+ (.NET 6)

— Suporta backtesting (sem IA) e trading ao vivo (com ou sem IA)

— Posições do bot são identificadas pelo rótulo `AiUS500Pro`

— Não interfere com posições manuais ou outros bots

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

⚠️ **AVISO LEGAL**

Este cBot é fornecido apenas para fins educacionais e informativos. Negociar índices envolve risco significativo de perda de capital. Resultados passados não garantem retornos futuros. A integração de IA melhora o filtro, mas não elimina o risco. Sempre teste em conta demo antes de usar em conta real. Você é o único responsável por suas decisões de negociação.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━