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

║ AI US500 PRO ║

║ cBot híbrido de tendencia / reversión a la media ║

║ Multi-AI • Multi-Marco temporal ║

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

🧠 **AI US500 PRO** es un cBot profesional para cTrader diseñado específicamente para el índice S&P 500 (US500). Combina análisis técnico multi-marco temporal con inteligencia artificial para filtrar cada operación antes de su ejecución.

El bot opera en **3 marcos temporales simultáneos** (H4 → H1 → M15), detecta automáticamente el régimen del mercado (tendencia o rango) y aplica la estrategia más adecuada: seguimiento de tendencia cuando el mercado tiene dirección, reversión a la media cuando se mueve lateralmente. Cada señal generada puede ser validada en tiempo real por un modelo de IA de su elección entre **13 proveedores soportados**.

Funciona con `AccessRights.None` — no requiere permisos especiales, utiliza las APIs HTTP nativas de cTrader.

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

📐 **ARQUITECTURA DE LA ESTRATEGIA**

El bot sigue un flujo de decisión en cascada:

```

H4 (EMA 200) → Determina la inclinación direccional a largo plazo (alcista / bajista / neutral)

↓

H1 (EMA 50 + RSI 14) → Confirma la dirección y evalúa la sobreextensión

↓

M15 (EMA 21/50 + Stoch + BB + ADX + ATR) → Genera la señal de entrada

↓

IA (Claude / GPT / Gemini / ...) → Filtra la señal con una puntuación de confianza

↓

Ejecución → Cálculo de volumen, SL/TP dinámicos, trailing stop

```

⚡ **Detección de Régimen (ADX)**

— ADX ≥ umbral → mercado en tendencia → estrategia de seguimiento de tendencia

— ADX < umbral → mercado en rango → estrategia de reversión a la media

El cambio es totalmente automático, barra a barra.

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

📊 **ESTRATEGIA DE SEGUIMIENTO DE TENDENCIA**

Condiciones de entrada LONG:

✅ H4: precio por encima de EMA 200 (sesgo alcista)

✅ H1: precio por encima de EMA 50 + RSI > 50

✅ M15: EMA 21 cruza por encima de EMA 50 (cruce alcista)

✅ M15: Stochastic K cruza por encima de D, con K < 65 (no sobrecomprado)

Condiciones de entrada SHORT: reflejadas e invertidas.

📊 **ESTRATEGIA DE REVERSIÓN A LA MEDIA**

Condiciones de entrada LONG:

✅ ADX por debajo del umbral (mercado en rango)

✅ M15: el precio toca o rompe la Banda de Bollinger inferior

✅ M15: Stochastic K < 20 (sobrevendido)

✅ H1: RSI < 35 (sobreextensión bajista)

Condiciones de entrada SHORT: reflejadas e invertidas.

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

🤖 **INTEGRACIÓN DE IA — 13 PROVEEDORES**

Cuando el bot genera una señal técnica válida, antes de ejecutarla envía a la IA un paquete de datos completo que contiene:

— Todos los indicadores multi-marco temporal

— Las últimas N velas M15 (OHLCV)

— Dirección propuesta y estrategia activa

— Parámetros de riesgo (SL/TP en pips, ratio R:R)

— Estado de la cuenta y posiciones abiertas

La IA responde con:

— **Puntuación de confianza** (0-100%)

— **Decisión** (GO / NO_GO)

— **Factores clave** (2-3 factores principales)

— **Advertencia de riesgo** (riesgo principal identificado)

Si la confianza cae por debajo del umbral mínimo, la operación es **bloqueada**.

Después de que cada operación se cierre, la IA también proporciona un **análisis post-operación** con evaluación, calificación y lección aprendida.

**Proveedores soportados:**

```

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, gratuito) — llama3.1

```

Cada proveedor tiene una URL y modelo predeterminados preconfigurados. Puede anular tanto el modelo como la URL para máxima flexibilidad.

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

🔧 **PARÁMETROS — GUÍA COMPLETA**

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

💰 **1. GESTIÓN DE RIESGO**

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

Elija entre tamaño de posición basado en porcentaje o lote fijo. En modo PercentRisk el bot calcula automáticamente el volumen basado en la distancia del stop loss y el capital disponible. Predeterminado: `PercentRisk`

▸ **% de Riesgo por Operación** — 0.1% a 5.0%

Porcentaje del saldo de la cuenta arriesgado en cada operación. El volumen se calcula para que si se alcanza el SL, la pérdida sea exactamente este porcentaje. Predeterminado: `1.0%`

▸ **Volumen Fijo (Lotes)** — 0.01 y más

Volumen fijo en lotes, solo se usa cuando el Modo de Riesgo está en FixedLot. Predeterminado: `0.1`

▸ **Máximo de Posiciones Abiertas** — 1 a 10

Número máximo de posiciones que el bot puede mantener simultáneamente. Cuando se alcanza el límite, no se abren nuevas operaciones. Predeterminado: `3`

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

📈 **2. SESGO DE TENDENCIA H4**

▸ **Periodo EMA H4** — 50 y más

Periodo de la EMA aplicada al marco temporal H4. Determina el sesgo direccional a largo plazo. Precio por encima de EMA = sesgo alcista, por debajo = bajista. Un buffer basado en ATR previene señales falsas cuando el precio está muy cerca del promedio. Predeterminado: `200`

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

🔍 **3. CONFIRMACIÓN H1**

▸ **Periodo EMA H1** — 10 y más

Periodo de la EMA en el marco temporal H1. El precio debe estar en el lado correcto de esta EMA para confirmar la entrada. Predeterminado: `50`

▸ **Periodo RSI H1** — 5 y más

Periodo del Índice de Fuerza Relativa en H1. Se usa tanto para la confirmación de tendencia (RSI > 50 para largos, < 50 para cortos) como para filtrar sobreextensiones en reversión a la media (RSI < 35 o > 65). Predeterminado: `14`

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

🎯 **4. ENTRADA M15**

▸ **Periodo EMA Rápida** — 5 y más

EMA rápida en el marco temporal de entrada (M15). El cruce con la EMA lenta genera la señal de seguimiento de tendencia. Predeterminado: `21`

▸ **Periodo EMA Lenta** — 10 y más

EMA lenta. El cruce EMA rápida/lenta es el disparador principal para la estrategia de tendencia. Predeterminado: `50`

▸ **Stochastic K / D / Slowing** — periodos del oscilador estocástico

Usado como confirmación de momentum. En la estrategia de tendencia filtra entradas en zonas no extremas; en reversión a la media identifica áreas de sobrecompra/sobreventa. Predeterminado: `K=14, D=3, Slowing=3`

▸ **Periodo Bollinger** — 10 y más

Periodo de las Bandas de Bollinger. En reversión a la media, un toque de la banda superior/inferior es el disparador de entrada. Predeterminado: `20`

▸ **Desviación estándar Bollinger** — 1.0 y más

Desviación estándar de las bandas. Valores más altos = bandas más anchas = menos señales pero más fiables. Predeterminado: `2.0`

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

🌡️ **5. DETECCIÓN DE RÉGIMEN (ADX)**

▸ **Periodo ADX** — 7 y más

Periodo del Sistema de Movimiento Direccional. Mide la fuerza de la tendencia sin importar la dirección. Predeterminado: `14`

▸ **Umbral de Tendencia ADX** — 15 a 40

Umbral que separa mercados en tendencia de mercados en rango. ADX por encima de este valor = seguimiento de tendencia activo; por debajo = reversión a la media activa. Predeterminado: `25`

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

🛡️ **6. SL / TP (BASADO EN ATR)**

Todos los stop loss y take profits son dinámicos, calculados como múltiplos del ATR actual. Esto significa que se adaptan automáticamente a la volatilidad: stops ajustados en mercados tranquilos, stops más amplios en mercados volátiles.

▸ **Periodo ATR** — 5 y más

Periodo del Average True Range. Mide la volatilidad reciente y sirve como base para cálculos de SL, TP, breakeven y trailing. Predeterminado: `14`

▸ **SL x ATR** — 0.5 y más

Multiplicador ATR para el stop loss. Ejemplo: con ATR = 20 puntos y multiplicador 1.5, el SL estará a 30 puntos del precio de entrada. Predeterminado: `1.5`

▸ **TP x ATR (Tendencia)** — 1.0 y más

Multiplicador ATR para el take profit en seguimiento de tendencia. Normalmente mayor que el SL para un R:R favorable. Predeterminado: `2.5`

▸ **TP x ATR (Reversión)** — 0.5 y más

Multiplicador ATR para el take profit en reversión a la media. Normalmente más conservador ya que el objetivo es un retorno a la media. Predeterminado: `1.5`

▸ **SL mínimo (Pips)** — 1 y más

Stop loss mínimo en pips. Si el cálculo del ATR produce un SL por debajo de este valor, se usa el mínimo en su lugar. Protege contra stops demasiado ajustados en condiciones de volatilidad ultra baja. Predeterminado: `10`

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

🔄 **7. TRAILING STOP**

Sistema de gestión activa para posiciones abiertas con breakeven automático y trailing stop, ambos basados en ATR.

▸ **Habilitar Trailing** — On/Off

Activa/desactiva todo el sistema de trailing. Cuando está apagado, las posiciones mantienen su SL/TP fijo hasta el cierre. Predeterminado: `On`

▸ **Breakeven después de x ATR** — 0.3 y más

Cuando la ganancia no realizada alcanza este múltiplo de ATR, el SL se mueve al precio de entrada (+ mitad del spread para cubrir costos). La operación se vuelve libre de riesgo. Predeterminado: `1.0`

▸ **Distancia de Trailing x ATR** — 0.5 y más

Distancia del trailing stop desde el precio actual, expresada como múltiplo de ATR. El SL sigue el precio y nunca retrocede. Predeterminado: `1.2`

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

🕐 **8. FILTRO DE SESIÓN**

Filtra la actividad de trading basada en el tiempo. US500 se comporta muy diferente durante el pre-mercado, la sesión regular y el after-hours.

▸ **Habilitar filtro de sesión** — On/Off

Activa/desactiva el filtro de tiempo. Predeterminado: `On`

▸ **Inicio de sesión (Hora CET)** — 0-23

Hora de inicio de la ventana de trading (zona horaria CET). Predeterminado: `15` (apertura sesión US)

▸ **Fin de sesión (Hora CET)** — 0-23

Hora de cierre de la ventana de trading. Predeterminado: `22` (cierre sesión US)

El bot también soporta sesiones que cruzan la medianoche (ej. Inicio=22, Fin=6).

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

⚙️ **9. VARIOS**

▸ **Cooldown (Barras)** — 0 y más

Número mínimo de barras M15 que deben pasar entre una operación y la siguiente. Previene sobreoperar en situaciones de señales rápidas. Predeterminado: `3` (= 45 minutos)

▸ **Mostrar Panel de Control** — On/Off

Muestra/oculta el panel de control en el gráfico con régimen, sesgo, indicadores, P&L, estado de IA y estadísticas en vivo. Predeterminado: `On`

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

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

▸ **Habilitar filtro IA** — On/Off

Activa/desactiva el filtro de IA. Cuando está apagado, el bot opera solo con análisis técnico. Predeterminado: `Off`

▸ **Proveedor de IA** — selección entre 13 proveedores

Elija qué proveedor de IA usar. Cada proveedor tiene una URL y modelo predeterminados preconfigurados. Predeterminado: `Anthropic`

▸ **Clave API** — cadena

Su clave API para el proveedor seleccionado. Requerida para todos los proveedores excepto Ollama (que se ejecuta localmente). Deje en blanco si usa Ollama.

▸ **Modelo (en blanco=predeterminado)** — cadena

Anulación del modelo de IA. Deje en blanco para usar el modelo predeterminado del proveedor seleccionado. Útil para probar modelos específicos (ej. "gpt-4o-mini", "claude-haiku-4-5-20251001").

▸ **URL API personalizada (en blanco=predeterminado)** — cadena

Anulación de URL API. Útil para Ollama en un puerto personalizado, proxies corporativos o endpoints personalizados.

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

Umbral mínimo de confianza de IA para aprobar una operación. Si la IA devuelve una puntuación por debajo de este valor, la operación se bloquea incluso si todas las señales técnicas son válidas. Predeterminado: `65`

▸ **Fail Open (permitir en error)** — On/Off

Comportamiento cuando la IA falla (timeout, API caída, respuesta malformada). On = la operación pasa de todos modos (fail-open). Off = la operación se bloquea (fail-closed). Predeterminado: `On`

▸ **Revisión IA post-operación** — On/Off

Cuando está habilitado, después de que cada operación se cierre el bot envía los detalles del resultado a la IA que proporciona una evaluación, calificación (BUENO/NEUTRO/MALO) y lección aprendida. Todo se registra en la consola. Predeterminado: `On`

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

Número de velas M15 recientes enviadas a la IA en el contexto del análisis. Más barras = más contexto pero más tokens consumidos. Predeterminado: `12`

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

📋 **PANEL DE CONTROL EN EL GRÁFICO**

El panel muestra en tiempo real:

— Régimen actual (TENDENCIA / RANGO)

— Sesgo H4 (ALCISTA / BAJISTA / PLANO)

— Valores de ADX, ATR, RSI H1

— Posiciones abiertas / máximo

— P&L abierto, balance, equity

— Estado de la sesión (ACTIVA / CERRADA)

— Total de operaciones y porcentaje de ganancia

— Estado de IA: proveedor, última decisión, confianza

— Conteo de llamadas IA y operaciones bloqueadas

El color cambia automáticamente: 🟢 verde cuando el P&L es positivo, 🔴 rojo cuando es negativo.

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

📌 **NOTAS TÉCNICAS**

— Marco temporal recomendado: **M15** (el bot avisa si se usa en otros TF)

— `AccessRights.None` — no requiere permisos especiales

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

— Compatible con cTrader 4.2+ (.NET 6)

— Soporta backtesting (sin IA) y trading en vivo (con o sin IA)

— Las posiciones del bot se identifican con la etiqueta `AiUS500Pro`

— No interfiere con posiciones manuales u otros bots

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

⚠️ **DESCARGO DE RESPONSABILIDAD**

Este cBot se proporciona solo con fines educativos e informativos. Operar con índices implica un riesgo significativo de pérdida de capital. Resultados pasados no garantizan rendimientos futuros. La integración de IA mejora el filtrado pero no elimina el riesgo. Siempre pruebe en una cuenta demo antes de usar en una cuenta real. Usted es el único responsable de sus decisiones de trading.

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