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

║ AI US500 PRO ║

║ Hybrydowy Trend / Mean-Reversion cBot ║

║ Multi-AI • Multi-Timeframe ║

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

🧠 **AI US500 PRO** to profesjonalny cBot dla cTrader, specjalnie zaprojektowany dla indeksu S&P 500 (US500). Łączy analizę techniczną na wielu interwałach czasowych ze sztuczną inteligencją, aby filtrować każdą transakcję przed jej wykonaniem.

Bot działa na **3 jednoczesnych interwałach czasowych** (H4 → H1 → M15), automatycznie wykrywa reżim rynku (trendowy lub boczny) i stosuje najbardziej odpowiednią strategię: podążanie za trendem, gdy rynek ma kierunek, mean-reversion, gdy porusza się bocznie. Każdy wygenerowany sygnał może być w czasie rzeczywistym zweryfikowany przez wybrany model AI spośród **13 obsługiwanych dostawców**.

Działa z `AccessRights.None` — nie wymaga specjalnych uprawnień, korzysta z natywnych API HTTP cTrader.

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

📐 **ARCHITEKTURA STRATEGII**

Bot podąża za kaskadowym przepływem decyzji:

```

H4 (EMA 200) → Określa długoterminowy kierunek (byczy / niedźwiedzi / neutralny)

↓

H1 (EMA 50 + RSI 14) → Potwierdza kierunek i ocenia przesadę ruchu

↓

M15 (EMA 21/50 + Stoch + BB + ADX + ATR) → Generuje sygnał wejścia

↓

AI (Claude / GPT / Gemini / ...) → Filtruje sygnał z oceną pewności

↓

Wykonanie → Obliczenie wolumenu, dynamiczne SL/TP, trailing stop

```

⚡ **Wykrywanie reżimu (ADX)**

— ADX ≥ próg → rynek trendowy → strategia podążania za trendem

— ADX < próg → rynek boczny → strategia mean-reversion

Przełączanie jest w pełni automatyczne, świeca po świecy.

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

📊 **STRATEGIA PODĄŻANIA ZA TRENDAMI**

Warunki wejścia LONG:

✅ H4: cena powyżej EMA 200 (byczy bias)

✅ H1: cena powyżej EMA 50 + RSI > 50

✅ M15: EMA 21 przecina powyżej EMA 50 (bycze przecięcie)

✅ M15: Stochastic K przecina powyżej D, z K < 65 (nieprzekupiony)

Warunki wejścia SHORT: lustrzane i odwrócone.

📊 **STRATEGIA MEAN-REVERSION**

Warunki wejścia LONG:

✅ ADX poniżej progu (rynek boczny)

✅ M15: cena dotyka lub przebija dolną wstęgę Bollingera

✅ M15: Stochastic K < 20 (wyprzedany)

✅ H1: RSI < 35 (niedźwiedzia przesada)

Warunki wejścia SHORT: lustrzane i odwrócone.

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

🤖 **INTEGRACJA AI — 13 DOSTAWCÓW**

Gdy bot generuje ważny sygnał techniczny, przed wykonaniem wysyła do AI kompletny pakiet danych zawierający:

— Wszystkie wskaźniki na wielu interwałach czasowych

— Ostatnie N świec M15 (OHLCV)

— Proponowany kierunek i aktywna strategia

— Parametry ryzyka (SL/TP w pipsach, stosunek R:R)

— Status konta i otwarte pozycje

AI odpowiada:

— **Ocena pewności** (0-100%)

— **Decyzja** (GO / NO_GO)

— **Kluczowe czynniki** (2-3 główne czynniki)

— **Ostrzeżenie o ryzyku** (główne zidentyfikowane ryzyko)

Jeśli ocena pewności spadnie poniżej minimalnego progu, transakcja jest **zablokowana**.

Po zamknięciu każdej transakcji AI dostarcza również **analizę po transakcji** z oceną, ratingiem i wyciągniętą lekcją.

**Obsługiwani dostawcy:**

```

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 (lokalny, darmowy) — llama3.1

```

Każdy dostawca ma prekonfigurowany domyślny URL i model. Możesz nadpisać zarówno model, jak i URL dla maksymalnej elastyczności.

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

🔧 **PARAMETRY — KOMPLETNY PRZEWODNIK**

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

💰 **1. ZARZĄDZANIE RYZYKIEM**

▸ **Tryb ryzyka** — `PercentRisk` / `FixedLot`

Wybierz między pozycjonowaniem opartym na procencie lub stałą wielkością lota. W trybie PercentRisk bot automatycznie oblicza wolumen na podstawie odległości stop loss i dostępnego kapitału. Domyślnie: `PercentRisk`

▸ **Ryzyko % na transakcję** — 0,1% do 5,0%

Procent salda konta ryzykowany w każdej transakcji. Wolumen jest obliczany tak, aby w przypadku trafienia SL strata wynosiła dokładnie ten procent. Domyślnie: `1,0%`

▸ **Stały wolumen (loty)** — 0,01 i więcej

Stały wolumen w lotach, używany tylko gdy tryb ryzyka ustawiony jest na FixedLot. Domyślnie: `0,1`

▸ **Maksymalna liczba otwartych pozycji** — 1 do 10

Maksymalna liczba pozycji, które bot może mieć jednocześnie otwarte. Po osiągnięciu limitu nie otwierane są nowe transakcje. Domyślnie: `3`

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

📈 **2. KIERUNEK TRENDU H4**

▸ **Okres EMA H4** — 50 i więcej

Okres EMA stosowany na interwale H4. Określa długoterminowy kierunek. Cena powyżej EMA = byczy kierunek, poniżej = niedźwiedzi. Bufor oparty na ATR zapobiega fałszywym sygnałom, gdy cena jest zbyt blisko średniej. Domyślnie: `200`

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

🔍 **3. POTWIERDZENIE H1**

▸ **Okres EMA H1** — 10 i więcej

Okres EMA na interwale H1. Cena musi znajdować się po właściwej stronie tej EMA, aby potwierdzić wejście. Domyślnie: `50`

▸ **Okres RSI H1** — 5 i więcej

Okres wskaźnika RSI na H1. Używany zarówno do potwierdzenia trendu (RSI > 50 dla longów, < 50 dla shortów), jak i filtrowania przesady w mean-reversion (RSI < 35 lub > 65). Domyślnie: `14`

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

🎯 **4. WEJŚCIE M15**

▸ **Okres szybkiej EMA** — 5 i więcej

Szybka EMA na interwale wejścia (M15). Przecięcie z wolną EMA generuje sygnał podążania za trendem. Domyślnie: `21`

▸ **Okres wolnej EMA** — 10 i więcej

Wolna EMA. Przecięcie szybkiej i wolnej EMA jest głównym wyzwalaczem strategii trendu. Domyślnie: `50`

▸ **Stochastic K / D / Spowolnienie** — okresy oscylatora stochastycznego

Używane jako potwierdzenie momentum. W strategii trendu filtruje wejścia w strefach nieekstremalnych; w mean-reversion identyfikuje obszary wykupienia/wyprzedania. Domyślnie: `K=14, D=3, Slowing=3`

▸ **Okres Bollingera** — 10 i więcej

Okres wstęg Bollingera. W mean-reversion dotknięcie górnej/dolnej wstęgi jest wyzwalaczem wejścia. Domyślnie: `20`

▸ **Odchylenie standardowe Bollingera** — 1,0 i więcej

Odchylenie standardowe wstęg. Wyższe wartości = szersze wstęgi = mniej, ale bardziej wiarygodnych sygnałów. Domyślnie: `2,0`

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

🌡️ **5. WYKRYWANIE REŻIMU (ADX)**

▸ **Okres ADX** — 7 i więcej

Okres systemu ruchu kierunkowego. Mierzy siłę trendu niezależnie od kierunku. Domyślnie: `14`

▸ **Próg trendu ADX** — 15 do 40

Próg oddzielający rynki trendowe od bocznych. ADX powyżej tej wartości = aktywna strategia podążania za trendem; poniżej = aktywna strategia mean-reversion. Domyślnie: `25`

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

🛡️ **6. SL / TP (OPARTE NA ATR)**

Wszystkie stop lossy i take profity są dynamiczne, obliczane jako wielokrotność aktualnego ATR. Oznacza to, że automatycznie dostosowują się do zmienności: ciasne stop lossy na spokojnych rynkach, szersze na zmiennych.

▸ **Okres ATR** — 5 i więcej

Okres Average True Range. Mierzy ostatnią zmienność i służy jako baza do obliczeń SL, TP, breakeven i trailing. Domyślnie: `14`

▸ **SL x ATR** — 0,5 i więcej

Mnożnik ATR dla stop lossa. Np.: przy ATR = 20 punktów i mnożniku 1,5 SL będzie 30 punktów od ceny wejścia. Domyślnie: `1,5`

▸ **TP x ATR (Trend)** — 1,0 i więcej

Mnożnik ATR dla take profitu w strategii podążania za trendem. Zwykle wyższy niż SL dla korzystnego stosunku R:R. Domyślnie: `2,5`

▸ **TP x ATR (Reversion)** — 0,5 i więcej

Mnożnik ATR dla take profitu w strategii mean-reversion. Zwykle bardziej konserwatywny, ponieważ celem jest powrót do średniej. Domyślnie: `1,5`

▸ **Minimalny SL (pipsy)** — 1 i więcej

Minimalny stop loss w pipsach. Jeśli obliczony ATR daje SL poniżej tej wartości, używany jest minimalny. Chroni przed zbyt ciasnymi stop lossami w warunkach bardzo niskiej zmienności. Domyślnie: `10`

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

🔄 **7. TRAILING STOP**

Aktywny system zarządzania otwartymi pozycjami z automatycznym breakeven i trailing stopem, oba oparte na ATR.

▸ **Włącz trailing** — Włącz/Wyłącz

Włącza/wyłącza cały system trailingu. Gdy wyłączony, pozycje zachowują stałe SL/TP do zamknięcia. Domyślnie: `Włącz`

▸ **Breakeven po x ATR** — 0,3 i więcej

Gdy niezrealizowany zysk osiąga tę wielokrotność ATR, SL jest przesuwany na cenę wejścia (+ połowa spreadu na pokrycie kosztów). Transakcja staje się bezryzykowna. Domyślnie: `1,0`

▸ **Odległość trailingu x ATR** — 0,5 i więcej

Odległość trailing stopa od aktualnej ceny, wyrażona jako wielokrotność ATR. SL podąża za ceną i nigdy się nie cofa. Domyślnie: `1,2`

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

🕐 **8. FILTR SESJI**

Filtruje aktywność handlową na podstawie czasu. US500 zachowuje się bardzo różnie podczas pre-market, sesji regularnej i po godzinach.

▸ **Włącz filtr sesji** — Włącz/Wyłącz

Włącza/wyłącza filtr czasowy. Domyślnie: `Włącz`

▸ **Początek sesji (godzina CET)** — 0-23

Godzina rozpoczęcia okna handlowego (strefa czasowa CET). Domyślnie: `15` (otwarcie sesji US)

▸ **Koniec sesji (godzina CET)** — 0-23

Godzina zakończenia okna handlowego. Domyślnie: `22` (zamknięcie sesji US)

Bot obsługuje również sesje przekraczające północ (np. Start=22, End=6).

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

⚙️ **9. RÓŻNE**

▸ **Cooldown (świece)** — 0 i więcej

Minimalna liczba świec M15, które muszą upłynąć między jedną a drugą transakcją. Zapobiega nadmiernemu handlowi w sytuacjach szybkich sygnałów. Domyślnie: `3` (= 45 minut)

▸ **Pokaż panel** — Włącz/Wyłącz

Pokazuje/ukrywa panel na wykresie z reżimem, biasem, wskaźnikami, P&L, statusem AI i statystykami na żywo. Domyślnie: `Włącz`

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

🤖 **10. ANALIZA AI**

▸ **Włącz filtr AI** — Włącz/Wyłącz

Włącza/wyłącza filtr AI. Gdy wyłączony, bot działa tylko na analizie technicznej. Domyślnie: `Wyłącz`

▸ **Dostawca AI** — wybór spośród 13 dostawców

Wybierz dostawcę AI. Każdy ma prekonfigurowany URL i model. Domyślnie: `Anthropic`

▸ **Klucz API** — ciąg znaków

Twój klucz API dla wybranego dostawcy. Wymagany dla wszystkich oprócz Ollama (działa lokalnie). Pozostaw puste przy użyciu Ollama.

▸ **Model (puste=domyślny)** — ciąg znaków

Nadpisanie modelu AI. Pozostaw puste, aby użyć domyślnego modelu dostawcy. Przydatne do testowania konkretnych modeli (np. "gpt-4o-mini", "claude-haiku-4-5-20251001").

▸ **Niestandardowy URL API (puste=domyślny)** — ciąg znaków

Nadpisanie URL API. Przydatne dla Ollama na niestandardowym porcie, korporacyjnych proxy lub niestandardowych endpointów.

▸ **Minimalna pewność (%)** — 30 do 95

Minimalny próg pewności AI do zatwierdzenia transakcji. Jeśli AI zwróci ocenę poniżej tego progu, transakcja jest zablokowana, nawet jeśli wszystkie sygnały techniczne są ważne. Domyślnie: `65`

▸ **Fail Open (zezwól na błąd)** — Włącz/Wyłącz

Zachowanie w przypadku awarii AI (timeout, niedostępne API, błędna odpowiedź). Włączone = transakcja przechodzi mimo błędu (fail-open). Wyłączone = transakcja jest blokowana (fail-closed). Domyślnie: `Włącz`

▸ **Analiza AI po transakcji** — Włącz/Wyłącz

Po zamknięciu każdej transakcji bot wysyła szczegóły wyniku do AI, które dostarcza ocenę, rating (DOBRY/NEUTRALNY/ZŁY) i wyciągniętą lekcję. Wszystko jest logowane do konsoli. Domyślnie: `Włącz`

▸ **Świece cenowe do AI** — 5 do 25

Liczba ostatnich świec M15 wysyłanych do AI w kontekście analizy. Więcej świec = więcej kontekstu, ale więcej zużytych tokenów. Domyślnie: `12`

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

📋 **PANEL NA WYKRESIE**

Panel wyświetla w czasie rzeczywistym:

— Aktualny reżim (TREND / BOCZNY)

— Bias H4 (BYCZY / NIEDŹWIEDZI / PŁASKI)

— Wartości ADX, ATR, RSI H1

— Otwarte pozycje / maksimum

— Otwarte P&L, saldo, kapitał własny

— Status sesji (AKTYWNA / ZAMKNIĘTA)

— Łączna liczba transakcji i procent wygranych

— Status AI: dostawca, ostatnia decyzja, pewność

— Liczba wywołań AI i zablokowane transakcje

Kolor zmienia się automatycznie: 🟢 zielony, gdy P&L jest dodatni, 🔴 czerwony, gdy ujemny.

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

📌 **NOTATKI TECHNICZNE**

— Zalecany interwał: **M15** (bot ostrzega, jeśli używany na innych TF)

— `AccessRights.None` — nie wymaga specjalnych uprawnień

— Korzysta z natywnej metody `Http.Send()` cTrader do wywołań AI

— Kompatybilny z cTrader 4.2+ (.NET 6)

— Obsługuje testy historyczne (bez AI) i handel na żywo (z AI lub bez)

— Pozycje bota oznaczone etykietą `AiUS500Pro`

— Nie koliduje z pozycjami manualnymi ani innymi botami

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

⚠️ **ZASTRZEŻENIE**

Ten cBot jest dostarczany wyłącznie w celach edukacyjnych i informacyjnych. Handel indeksami wiąże się ze znacznym ryzykiem utraty kapitału. Wyniki historyczne nie gwarantują przyszłych zysków. Integracja AI poprawia filtrowanie, ale nie eliminuje ryzyka. Zawsze testuj na koncie demo przed użyciem na koncie rzeczywistym. Jesteś wyłącznie odpowiedzialny za swoje decyzje handlowe.

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