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

║ AI US500 PRO ║

║ cBot ibrido Trend / Mean-Reversion ║

║ Multi-AI • Multi-Timeframe ║

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

🧠 **AI US500 PRO** è un cBot professionale per cTrader specificamente progettato per l'indice S&P 500 (US500). Combina l'analisi tecnica multi-timeframe con l'intelligenza artificiale per filtrare ogni operazione prima dell'esecuzione.

Il bot opera su **3 timeframe simultanei** (H4 → H1 → M15), rileva automaticamente il regime di mercato (in trend o laterale) e applica la strategia più adatta: trend-following quando il mercato ha direzione, mean-reversion quando si muove lateralmente. Ogni segnale generato può essere validato in tempo reale da un modello AI a scelta tra **13 provider supportati**.

Funziona con `AccessRights.None` — nessun permesso speciale richiesto, utilizza le API HTTP native di cTrader.

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

📐 **ARCHITETTURA DELLA STRATEGIA**

Il bot segue un flusso decisionale a cascata:

```

H4 (EMA 200) → Determina il bias direzionale a lungo termine (rialzista / ribassista / neutro)

↓

H1 (EMA 50 + RSI 14) → Conferma la direzione e valuta l'eccesso di estensione

↓

M15 (EMA 21/50 + Stoch + BB + ADX + ATR) → Genera il segnale di ingresso

↓

AI (Claude / GPT / Gemini / ...) → Filtra il segnale con un punteggio di confidenza

↓

Esecuzione → Calcolo del volume, SL/TP dinamici, trailing stop

```

⚡ **Rilevamento del regime (ADX)**

— ADX ≥ soglia → mercato in trend → strategia trend-following

— ADX < soglia → mercato laterale → strategia mean-reversion

Il passaggio è completamente automatico, barra per barra.

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

📊 **STRATEGIA TREND-FOLLOWING**

Condizioni di ingresso LONG:

✅ H4: prezzo sopra EMA 200 (bias rialzista)

✅ H1: prezzo sopra EMA 50 + RSI > 50

✅ M15: EMA 21 incrocia sopra EMA 50 (crossover rialzista)

✅ M15: Stochastic K incrocia sopra D, con K < 65 (non ipercomprato)

Condizioni di ingresso SHORT: speculari e invertite.

📊 **STRATEGIA MEAN-REVERSION**

Condizioni di ingresso LONG:

✅ ADX sotto soglia (mercato laterale)

✅ M15: prezzo tocca o rompe la banda inferiore di Bollinger

✅ M15: Stochastic K < 20 (ipervenduto)

✅ H1: RSI < 35 (eccesso ribassista)

Condizioni di ingresso SHORT: speculari e invertite.

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

🤖 **INTEGRAZIONE AI — 13 PROVIDER**

Quando il bot genera un segnale tecnico valido, prima di eseguirlo invia all'AI un pacchetto dati completo contenente:

— Tutti gli indicatori multi-timeframe

— Le ultime N candele M15 (OHLCV)

— Direzione proposta e strategia attiva

— Parametri di rischio (SL/TP in pips, rapporto R:R)

— Stato del conto e posizioni aperte

L'AI risponde con:

— **Punteggio di confidenza** (0-100%)

— **Decisione** (GO / NO_GO)

— **Fattori chiave** (2-3 fattori principali)

— **Avviso di rischio** (rischio principale identificato)

Se la confidenza scende sotto la soglia minima, l'operazione viene **bloccata**.

Dopo la chiusura di ogni operazione, l'AI fornisce anche un'**analisi post-trade** con valutazione, rating e lezione appresa.

**Provider supportati:**

```

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

```

Ogni provider ha un URL e un modello preconfigurati di default. Puoi sovrascrivere sia il modello che l'URL per la massima flessibilità.

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

🔧 **PARAMETRI — GUIDA COMPLETA**

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

💰 **1. GESTIONE DEL RISCHIO**

▸ **Modalità Rischio** — `PercentRisk` / `FixedLot`

Scegli tra dimensionamento della posizione basato su percentuale o lotto fisso. In modalità PercentRisk il bot calcola automaticamente il volume basandosi sulla distanza dello stop loss e sul capitale disponibile. Default: `PercentRisk`

▸ **% Rischio per Operazione** — 0.1% a 5.0%

Percentuale del saldo del conto rischiata in ogni operazione. Il volume è calcolato in modo che se lo SL viene colpito, la perdita sia esattamente questa percentuale. Default: `1.0%`

▸ **Volume Fisso (Lotti)** — 0.01 e oltre

Volume fisso in lotti, usato solo quando la modalità rischio è impostata su FixedLot. Default: `0.1`

▸ **Massimo Posizioni Aperte** — 1 a 10

Numero massimo di posizioni che il bot può mantenere simultaneamente. Quando il limite è raggiunto, non vengono aperte nuove operazioni. Default: `3`

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

📈 **2. BIAS TREND H4**

▸ **Periodo EMA H4** — 50 e oltre

Periodo EMA applicato al timeframe H4. Determina il bias direzionale a lungo termine. Prezzo sopra EMA = bias rialzista, sotto = ribassista. Un buffer basato su ATR previene falsi segnali quando il prezzo è troppo vicino alla media. Default: `200`

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

🔍 **3. CONFERMA H1**

▸ **Periodo EMA H1** — 10 e oltre

Periodo EMA sul timeframe H1. Il prezzo deve essere dal lato corretto di questa EMA per confermare l'ingresso. Default: `50`

▸ **Periodo RSI H1** — 5 e oltre

Periodo dell'Indice di Forza Relativa su H1. Usato sia per la conferma del trend (RSI > 50 per long, < 50 per short) sia per il filtro di eccesso in mean-reversion (RSI < 35 o > 65). Default: `14`

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

🎯 **4. INGRESSO M15**

▸ **Periodo EMA Veloce** — 5 e oltre

EMA veloce sul timeframe di ingresso (M15). Il crossover con l'EMA lenta genera il segnale trend-following. Default: `21`

▸ **Periodo EMA Lenta** — 10 e oltre

EMA lenta. Il crossover EMA veloce/lenta è il trigger principale per la strategia di trend. Default: `50`

▸ **Stochastic K / D / Slowing** — periodi dell'oscillatore stocastico

Usati come conferma di momentum. Nella strategia trend filtra gli ingressi in zone non estreme; nella mean-reversion identifica aree di ipercomprato/ipervenduto. Default: `K=14, D=3, Slowing=3`

▸ **Periodo Bollinger** — 10 e oltre

Periodo delle Bande di Bollinger. Nella mean-reversion, il tocco della banda superiore/inferiore è il trigger di ingresso. Default: `20`

▸ **Deviazione Std Bollinger** — 1.0 e oltre

Deviazione standard delle bande. Valori più alti = bande più larghe = segnali meno frequenti ma più affidabili. Default: `2.0`

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

🌡️ **5. RILEVAMENTO REGIME (ADX)**

▸ **Periodo ADX** — 7 e oltre

Periodo del Sistema di Movimento Direzionale. Misura la forza del trend indipendentemente dalla direzione. Default: `14`

▸ **Soglia Trend ADX** — 15 a 40

Soglia che separa mercati in trend da mercati laterali. ADX sopra questo valore = trend-following attivo; sotto = mean-reversion attivo. Default: `25`

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

🛡️ **6. SL / TP (BASATI SU ATR)**

Tutti gli stop loss e take profit sono dinamici, calcolati come multipli dell'ATR corrente. Ciò significa che si adattano automaticamente alla volatilità: stop stretti in mercati calmi, stop più ampi in mercati volatili.

▸ **Periodo ATR** — 5 e oltre

Periodo dell'Average True Range. Misura la volatilità recente e serve come base per SL, TP, breakeven e trailing. Default: `14`

▸ **SL x ATR** — 0.5 e oltre

Moltiplicatore ATR per lo stop loss. Es.: con ATR = 20 punti e moltiplicatore 1.5, lo SL sarà a 30 punti dal prezzo di ingresso. Default: `1.5`

▸ **TP x ATR (Trend)** — 1.0 e oltre

Moltiplicatore ATR per il take profit nella strategia trend-following. Tipicamente più alto dello SL per un rapporto R:R favorevole. Default: `2.5`

▸ **TP x ATR (Reversion)** — 0.5 e oltre

Moltiplicatore ATR per il take profit nella mean-reversion. Tipicamente più conservativo poiché l'obiettivo è un ritorno alla media. Default: `1.5`

▸ **Min SL (Pips)** — 1 e oltre

Stop loss minimo in pips. Se il calcolo ATR produce uno SL inferiore a questo valore, viene usato il minimo. Protegge da stop troppo stretti in condizioni di volatilità ultra-bassa. Default: `10`

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

🔄 **7. TRAILING STOP**

Sistema di gestione attiva per posizioni aperte con breakeven automatico e trailing stop, entrambi basati su ATR.

▸ **Abilita Trailing** — On/Off

Abilita/disabilita l'intero sistema di trailing. Quando spento, le posizioni mantengono SL/TP fissi fino alla chiusura. Default: `On`

▸ **Breakeven Dopo x ATR** — 0.3 e oltre

Quando il profitto non realizzato raggiunge questo multiplo ATR, lo SL viene spostato al prezzo di ingresso (+ metà spread per coprire i costi). L'operazione diventa a rischio zero. Default: `1.0`

▸ **Distanza Trailing x ATR** — 0.5 e oltre

Distanza del trailing stop dal prezzo corrente, espressa come multiplo ATR. Lo SL segue il prezzo e non torna mai indietro. Default: `1.2`

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

🕐 **8. FILTRO SESSIONE**

Filtra l'attività di trading basandosi sull'orario. US500 si comporta in modo molto diverso durante il pre-mercato, la sessione regolare e l'after-hours.

▸ **Abilita Filtro Sessione** — On/Off

Abilita/disabilita il filtro temporale. Default: `On`

▸ **Inizio Sessione (Ora CET)** — 0-23

Ora di inizio della finestra di trading (fuso orario CET). Default: `15` (apertura sessione US)

▸ **Fine Sessione (Ora CET)** — 0-23

Ora di fine della finestra di trading. Default: `22` (chiusura sessione US)

Il bot supporta anche sessioni che attraversano la mezzanotte (es. Inizio=22, Fine=6).

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

⚙️ **9. VARIE**

▸ **Cooldown (Barre)** — 0 e oltre

Numero minimo di barre M15 che devono passare tra un'operazione e la successiva. Previene l'overtrading in situazioni di segnali rapidi. Default: `3` (= 45 minuti)

▸ **Mostra Dashboard** — On/Off

Mostra/nasconde la dashboard sul grafico con regime, bias, indicatori, P&L, stato AI e statistiche live. Default: `On`

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

🤖 **10. ANALISI AI**

▸ **Abilita Filtro AI** — On/Off

Abilita/disabilita il filtro AI. Quando spento, il bot opera solo con l'analisi tecnica. Default: `Off`

▸ **Provider AI** — selezione tra 13 provider

Scegli quale provider AI utilizzare. Ogni provider ha un URL e modello preconfigurati. Default: `Anthropic`

▸ **Chiave API** — stringa

La tua chiave API per il provider selezionato. Richiesta per tutti i provider tranne Ollama (che gira localmente). Lascia vuoto se usi Ollama.

▸ **Modello (vuoto=default)** — stringa

Override del modello AI. Lascia vuoto per usare il modello predefinito del provider selezionato. Utile per testare modelli specifici (es. "gpt-4o-mini", "claude-haiku-4-5-20251001").

▸ **URL API Personalizzato (vuoto=default)** — stringa

Override dell'URL API. Utile per Ollama su porta personalizzata, proxy aziendali o endpoint custom.

▸ **Confidenza Minima (%)** — 30 a 95

Soglia minima di confidenza AI per approvare un'operazione. Se l'AI restituisce un punteggio inferiore, l'operazione viene bloccata anche se tutti i segnali tecnici sono validi. Default: `65`

▸ **Fail Open (consenti in caso di errore)** — On/Off

Comportamento quando l'AI fallisce (timeout, API down, risposta malformata). On = l'operazione viene comunque eseguita (fail-open). Off = l'operazione è bloccata (fail-closed). Default: `On`

▸ **Revisione AI Post-Trade** — On/Off

Quando abilitato, dopo la chiusura di ogni operazione il bot invia i dettagli del risultato all'AI che fornisce una valutazione, un rating (BUONO/NEUTRO/MALE) e una lezione appresa. Tutto viene registrato nella console. Default: `On`

▸ **Barre Prezzo per AI** — 5 a 25

Numero di candele M15 recenti inviate all'AI nel contesto di analisi. Più barre = più contesto ma più token consumati. Default: `12`

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

📋 **DASHBOARD SUL GRAFICO**

La dashboard mostra in tempo reale:

— Regime attuale (TREND / RANGE)

— Bias H4 (BULL / BEAR / FLAT)

— Valori ADX, ATR, RSI H1

— Posizioni aperte / massimo

— P&L aperto, saldo, equity

— Stato sessione (ATTIVA / CHIUSA)

— Totale operazioni e % di vincita

— Stato AI: provider, ultima decisione, confidenza

— Conteggio chiamate AI e operazioni bloccate

Il colore cambia automaticamente: 🟢 verde quando il P&L è positivo, 🔴 rosso quando è negativo.

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

📌 **NOTE TECNICHE**

— Timeframe consigliato: **M15** (il bot avvisa se usato su altri TF)

— `AccessRights.None` — nessun permesso speciale richiesto

— Usa la funzione nativa `Http.Send()` di cTrader per le chiamate AI

— Compatibile con cTrader 4.2+ (.NET 6)

— Supporta backtesting (senza AI) e trading live (con o senza AI)

— Le posizioni del bot sono identificate dall'etichetta `AiUS500Pro`

— Non interferisce con posizioni manuali o altri bot

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

⚠️ **DISCLAIMER**

Questo cBot è fornito solo a scopo educativo e informativo. Il trading di indici comporta un rischio significativo di perdita di capitale. I risultati passati non garantiscono rendimenti futuri. L'integrazione AI migliora il filtraggio ma non elimina il rischio. Testa sempre su un conto demo prima di usare su un conto reale. Sei l'unico responsabile delle tue decisioni di trading.

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