Breakout AI Pro to nie jest kolejny bot do breakoutów. Łączy sprawdzoną logikę price-action breakout z 6 modułami adaptacyjnymi opartymi na AI, które analizują kontekst rynku przed każdym pojedynczym wejściem. Efekt: mniej fałszywych breakoutów, inteligentniejsze ustawianie SL/TP oraz konsekwentne zarządzanie ryzykiem na dowolnym instrumencie.

=== JAK TO DZIAŁA ===

Bot oblicza najwyższy szczyt i najniższy dołek w konfigurowalnym okresie wstecz. Gdy cena wchodzi w interakcję z tymi poziomami, wykrywa 3 typy sygnałów:

- BREAK: Cena właśnie przebiła poziom. Klasyczny sygnał momentum/kontynuacji.

- APPROACH: Cena znajduje się w odległości X pipsów od poziomu, ale go nie przebija. Sygnał oczekiwania.

- RETURN: Cena przebiła poziom, ale wróciła do środka. Sygnał odwrócenia do średniej / pułapka.

Dla każdego typu sygnału (Break, Approach, Return) na poziomach High i Low możesz niezależnie włączyć wejścia KUP i/lub SPRZEDAJ. Daje to pełną kontrolę nad strategią: podążanie za trendem, przeciwtrendową lub hybrydową.

Przed otwarciem pozycji sygnał przechodzi przez 7 kolejnych filtrów AI. Jeśli którykolwiek z nich zostanie niezaliczony, transakcja jest odrzucana.

=== 6 MODUŁÓW AI ===

1. WYKRYWANIE REŻIMU ZMIENNOŚCI

Używa percentyli ATR do klasyfikacji rynku jako niskiej, średniej lub wysokiej zmienności. Przy niskiej zmienności breakouty statystycznie częściej są fałszywe — bot automatycznie blokuje wejścia. Przy wysokiej zmienności SL/TP są rozszerzane, aby uwzględnić większe ruchy.

2. FILTR MOMENTUM RSI

Blokuje wejścia KUP, gdy RSI jest wykupiony, oraz wejścia SPRZEDAJ, gdy RSI jest wyprzedany. Opcjonalne wykrywanie dywergencji dodaje dodatkową warstwę potwierdzenia. Zapobiega wejściom przy wyczerpanym momentum.

3. ADAPTACYJNY SL/TP (OPARTY NA ATR)

Stop Loss i Take Profit są obliczane jako wielokrotności aktualnego ATR — nie jako wartości stałe. Bot dostosowuje się do rzeczywistych warunków rynkowych: ciasny SL na spokojnych rynkach, szerszy SL na rynkach zmiennych. Ograniczenia Min/Max zapewniają, że wartości zawsze mieszczą się w zdefiniowanych granicach.

4. OCENA JAKOŚCI WEJŚCIA

Każdy sygnał otrzymuje ocenę od 0 do 100 na podstawie 4 czynników:

- Reżim zmienności (średni jest najlepszy dla breakoutów)

- Zgodność RSI z kierunkiem transakcji

- Siła breakoutu (odległość od poziomu względem ATR)

- Jakość świecy (normalny zakres vs spike vs doji)

Tylko sygnały powyżej minimalnego progu są realizowane.

5. DYNAMICZNE USTAWIANIE WIELKOŚCI POZYCJI

Zamiast stałych lotów, bot oblicza wolumen na podstawie procentowego ryzyka na transakcję i adaptacyjnej odległości SL. Opcjonalnie skaluje wielkość pozycji według oceny jakości — wyższa pewność = większa pozycja, niższa pewność = mniejsza pozycja.

6. INTELIGENTNY SYSTEM ODPOCZYNKU

Po trafieniu stop lossa bot czeka konfigurowalną liczbę świec przed ponownym wejściem tego samego typu sygnału. Zapobiega to destrukcyjnemu cyklowi SL → natychmiastowe ponowne wejście → SL → ponowne wejście, który może wyczerpać konto.

=== FUNKCJE BEZPIECZEŃSTWA ===

- WYBIERZ JEDNOSTKĘ: Wybierz, czy wszystkie wartości SL/TP/BE/Trailing są w PIPS czy ODLEGŁOŚCI CENOWEJ. Działa idealnie na każdym instrumencie — Forex, Crypto, Indeksy, Surowce.

- OCHRONA PRZED PRZECIWSTAWNYMI: Zapobiega otwieraniu KUP i SPRZEDAJ na tej samej świecy.

- WYMUSZENIE SL/TP: Przy każdym ticku bot weryfikuje, czy wszystkie otwarte pozycje mają ważne SL i TP. Jeśli brakuje, natychmiast stosuje wartości awaryjne.

- WERYFIKACJA SL: Po otwarciu pozycji bot potwierdza, że SL został faktycznie zastosowany. Jeśli broker go odrzuci, pozycja jest natychmiast zamykana. Nigdy nie ma niechronionych pozycji.

- KONTROLA MAKSYMALNEJ EKSPOZYCJI: Konfigurowalne limity maksymalnych pozycji LONG, SHORT oraz łącznej liczby pozycji.

=== GOTOWY NA PROP FIRMĘ ===

Wbudowany monitoring dziennego i całkowitego obsunięcia w walucie konta. Po przekroczeniu limitów wybierz jedną z 3 akcji:

- Zamknij wszystko: Natychmiast zamyka wszystkie pozycje i blokuje nowe wejścia na dany dzień.

- Blokuj nowe: Utrzymuje istniejące pozycje, ale zapobiega otwieraniu nowych.

- Hedging: Otwiera przeciwne pozycje, aby zabezpieczyć aktualny P&L.

=== ZARZĄDZANIE POZYCJĄ ===

- BREAK EVEN: Przesuwa SL do ceny wejścia + offset, gdy zysk osiągnie poziom wyzwalający. Zabezpiecza mały gwarantowany zysk.

- TRAILING STOP: Gdy zysk osiągnie poziom startowy, SL podąża za ceną w stałej odległości. Pozwala na kontynuację zyskownych pozycji przy jednoczesnej ochronie zysków.

- Wszystkie wartości respektują wybrany system jednostek (pipsy lub odległość cenową).

=== PRZEWODNIK PO PARAMETRACH ===

1. PARAMETRY PODSTAWOWE

- PreviousPeriodBars (48): Liczba świec do obliczenia High/Low. 48 świec na M5 = 4 godziny.

- OnBarOnly (true): Sprawdzaj warunki na zamknięciu świecy (stabilne) lub przy każdym ticku (reaktywne).

- VolumeLots (0.1): Stały wolumen na transakcję. Ignorowany, jeśli włączone jest Dynamiczne Ustawianie.

1b. SYSTEM JEDNOSTEK

- InputInPips (true): Jeśli prawda, wszystkie wartości SL/TP/BE/Trailing są w PIPS. Jeśli fałsz, są w odległości cenowej. Krytyczne dla poprawnej pracy na różnych instrumentach.

2. AI — ZMIENNOŚĆ

- EnableVolatilityFilter (true): Włącz klasyfikację reżimu opartą na ATR.

- AtrPeriod (14): Okres wskaźnika ATR.

- AtrLookback (50): Liczba świec ATR do obliczenia percentyli.

- LowVolPercentile (25): Poniżej tego percentyla = niski reżim.

- HighVolPercentile (75): Powyżej tego percentyla = wysoki reżim.

- BlockLowVolatility (true): Blokuj wszystkie wejścia podczas niskiej zmienności.

3. AI — MOMENTUM

- EnableRsiFilter (true): Włącz filtrowanie wejść oparte na RSI.

- RsiPeriod (14): Okres wskaźnika RSI.

- RsiOverbought (70): Próg wykupienia.

- RsiOversold (30): Próg wyprzedania.

- BlockBuyOverbought (true): Blokuj KUP, gdy RSI >= wykupiony.

- BlockSellOversold (true): Blokuj SPRZEDAJ, gdy RSI <= wyprzedany.

- RequireDivergenceConfirmation (false): Blokuj wejścia przy dywergencji RSI/ceny.

- DivergenceLookback (10): Liczba świec do sprawdzenia dywergencji.

4. AI — ADAPTACYJNY SL/TP

- EnableAdaptiveSLTP (true): Obliczaj SL/TP na podstawie ATR. Jeśli fałsz, używa wartości stałych.

- AtrMultiplierSL (1.5): SL = ATR x mnożnik.

- AtrMultiplierTP (2.5): TP = ATR x mnożnik. Domyślny stosunek R:R = 1.67.

- MinSL (500): Minimalny SL (w wybranej jednostce).

- MaxSL (5000): Maksymalny SL. Ograniczenie jest stosowane PO dostosowaniu do zmienności.

- MinTP (800): Minimalny TP.

- MaxTP (10000): Maksymalny TP.

5. AI — OCENA JAKOŚCI

- EnableQualityScore (true): Włącz ocenę jakości sygnału.

- MinQualityScore (40): Minimalna ocena (0-100) do otwarcia transakcji.

6. AI — DYNAMICZNE USTAWIANIE WIELKOŚCI

- EnableDynamicSizing (false): Obliczaj wolumen na podstawie % ryzyka.

- RiskPercentage (1.0): % kapitału do ryzyka na transakcję.

- ScaleByQuality (true): Zmniejsz wolumen dla sygnałów niskiej jakości (min 30%).

6b. AI — ODPOCZYNEK

- CooldownBarsAfterSL (6): Liczba świec do odczekania po stop lossie przed ponownym wejściem tego samego sygnału.

- BlockOpposingOnSameBar (true): Zapobiega KUP+SPRZEDAJ na tej samej świecy.

- MaxTotalPositions (2): Maksymalna łączna liczba otwartych pozycji.

7. PRZEBICIE HIGH

- BuyOnBreakHigh (true): Otwórz KUP przy przebiciu high.

- SellOnBreakHigh (false): Otwórz SPRZEDAJ przy przebiciu high (przeciwtrendowo).

- ApproachPipsHigh (15): Odległość w pipsach do wykrycia podejścia.

- BuyOnApproachHigh (false): Otwórz KUP przy podejściu do high.

- SellOnApproachHigh (false): Otwórz SPRZEDAJ przy podejściu.

- BuyOnReturnHigh (false): Otwórz KUP przy powrocie poniżej high.

- SellOnReturnHigh (false): Otwórz SPRZEDAJ przy powrocie.

8. PRZEBICIE LOW

- SellOnBreakLow (true): Otwórz SPRZEDAJ przy przebiciu low.

- BuyOnBreakLow (false): Otwórz KUP przy przebiciu low (przeciwtrendowo).

- ApproachPipsLow (15): Odległość do wykrycia podejścia.

- Wszystkie opcje Approach/Return takie same jak przy Break High.

9. LIMITY POZYCJI

- MaxLong (1): Maksymalna liczba jednoczesnych pozycji LONG.

- MaxShort (1): Maksymalna liczba jednoczesnych pozycji SHORT.

10. ZARZĄDZANIE RYZYKIEM (STAŁE)

- StopLossLong/Short (3000): Stały SL, gdy Adaptive jest WYŁĄCZONY.

- TakeProfitLong/Short (6000): Stały TP, gdy Adaptive jest WYŁĄCZONY.

- Wyzwalacz/przesunięcie BreakEven: Gdy zysk osiągnie wyzwalacz, SL przesuwa się do wejścia + przesunięcie.

- Start/krok Trailing: Gdy zysk osiągnie start, SL podąża za ceną w odległości kroku.

11. KONTROLA RYZYKA PROP

- EnablePropRisk (true): Włącz monitoring obsunięcia.

- MaxDailyDrawdown (500): Maksymalna dzienna strata w walucie konta.

- MaxTotalDrawdown (1500): Maksymalna całkowita strata od startu bota.

- OnBreachAction (0): 0=Zamknij wszystko, 1=Blokuj nowe, 2=Hedging.

- HedgeVolumeMultiplier (1.0): Mnożnik wolumenu dla pozycji hedgingowych.

=== SUGEROWANE KONFIGURACJE ===

BTCUSD M5 (Crypto):

InputInPips=false, MinSL=200, MaxSL=1500, MinTP=300, MaxTP=3000, wyzwalacz BE=400, krok trailing=150, PreviousPeriodBars=48.

EURUSD M15 (Forex):

InputInPips=true, MinSL=15, MaxSL=80, MinTP=25, MaxTP=150, wyzwalacz BE=30, krok trailing=10, PreviousPeriodBars=96.

US30 M5 (Indeksy):

InputInPips=false, MinSL=30, MaxSL=200, MinTP=50, MaxTP=400, PreviousPeriodBars=48.

=== WAŻNE UWAGI ===

- Wszystkie moduły AI mogą być włączane/wyłączane niezależnie. Zacznij od wszystkich WŁĄCZONYCH (domyślnie) i wyłączaj pojedynczo, aby przetestować wpływ.

- Bot rejestruje każdą decyzję z wartościami cenowymi i pipowymi. Sprawdź log przy starcie, aby zweryfikować poprawność konwersji jednostek.

- Zawsze testuj najpierw na koncie demo. Wyniki historyczne nie gwarantują przyszłych rezultatów.

- Handel wiąże się z istotnym ryzykiem. To oprogramowanie to narzędzie do automatyzacji handlu, a nie porada finansowa.