Dokumentacja - Entry plugins

Sekcja Entry Plugins pozwala rozszerzyć działanie Pine Algo o dodatkowe filtry wejścia, które pełnią rolę zewnętrznych potwierdzeń sygnału handlowego. Dzięki nim można znacznie zwiększyć precyzję wejść, ograniczyć liczbę błędnych transakcji i dostosować strategię do własnego stylu handlu, niezależnie od trybu pracy (DCA lub Sniper).

System obsługuje dwa równorzędne pluginy wejścia, które mogą działać niezależnie lub wspólnie. Każdy z nich jest osobnym filtrem, a ich logika działania jest łączona w sposób, który pozwala użytkownikowi w pełni kontrolować warunki otwierania pozycji.

Jak działają Entry Plugins

Każdy plugin analizuje wskazane źródło danych (source) i porównuje je z bieżącym kierunkiem transakcji. Jeśli plugin jest włączony, strategia otworzy pozycję tylko wtedy, gdy jego warunek zostanie spełniony. Jeżeli warunek nie jest spełniony, wejście zostanie pominięte - nawet jeśli główny sygnał strategii wskazuje moment otwarcia pozycji.

Dzięki temu Pine Algo może działać bardziej selektywnie, reagując wyłącznie na potwierdzone sygnały. To szczególnie istotne na rynkach o wysokiej zmienności, gdzie liczba fałszywych impulsów cenowych bywa duża, a filtrowanie wejść przekłada się bezpośrednio na stabilność wyników.

Konfiguracja pluginów

Każdy z dwóch dostępnych pluginów posiada identyczny zestaw parametrów konfiguracyjnych:

Enabled - włącza lub wyłącza dany plugin. Gdy opcja jest wyłączona, filtr nie ma wpływu na logikę strategii. Włączenie go powoduje, że Pine Algo zaczyna uwzględniać jego sygnały podczas oceny momentu wejścia.
Source - definiuje źródło danych, z którego plugin będzie odczytywać sygnały. Może to być np.
Reverse - odwraca logikę działania pluginu. Gdy funkcja jest aktywna, sygnał uznawany normalnie za pozytywny (np. wzrostowy) traktowany jest odwrotnie - jako negatywny, i odwrotnie. Dzięki temu można elastycznie dopasować plugin do wskaźników, które działają w innej logice niż główny sygnał Pine Algo.

Współpraca pluginów

Oba pluginy działają równolegle, a ich logika jest łączona w sposób koniunkcyjny - czyli AND. Oznacza to, że:

jeśli włączony jest tylko jeden plugin, wystarczy jego potwierdzenie,
jeśli aktywne są oba, oba muszą jednocześnie potwierdzić sygnał,
jeśli żaden nie jest aktywny, Pine Algo działa w trybie podstawowym, bez filtrów wejścia.

Taka konstrukcja pozwala z łatwością przełączać się między stylem konserwatywnym (oba pluginy aktywne i ściśle potwierdzające sygnały) a bardziej elastycznym (jeden plugin aktywny lub brak filtrów). Dzięki temu użytkownik może decydować, jak restrykcyjna ma być strategia i jak bardzo ma ufać sygnałom bazowym.

Zastosowanie w trybie DCA i Sniper

W trybie DCA pluginy pełnią rolę filtrów ograniczających nadmierną liczbę dokupów w niekorzystnych warunkach. Na przykład - jeśli główny sygnał wskazuje dokup, ale aktywny plugin wykrywa spadkowe momentum lub brak potwierdzenia trendu, pozycja nie zostanie zwiększona. Pozwala to zachować większą stabilność kapitału i zapobiec zbyt agresywnemu skalowaniu pozycji.

W trybie Sniper natomiast pluginy odgrywają kluczową rolę w selekcji transakcji. Rekomendowane jest używanie przynajmniej jednego z nich, aby potwierdzać wejścia dodatkowymi sygnałami - na przykład na podstawie trendu, wskaźników siły rynku (RSI, MACD) lub wolumenu. Dzięki temu strategia otwiera tylko te pozycje, które spełniają dodatkowe warunki techniczne, co znacząco zwiększa precyzję i skuteczność.

Przykład: Filtrowanie otwierania zleceń przy pomocy średnich kroczących

Jednym z najczęściej stosowanych i najskuteczniejszych sposobów wykorzystania pluginów wejścia jest filtrowanie zleceń przy pomocy średnich kroczących. Pozwala to otwierać pozycje tylko wtedy, gdy rynek znajduje się w zgodnym kierunku trendu, co zwiększa stabilność i ogranicza handel przeciwko głównemu ruchowi ceny.

Przykład konfiguracji:

1) Dodaj na wykres plugin Moving Averages [psyll]. To dedykowany wskaźnik Pine, który umożliwia generowanie sygnałów typu Above/Below Price w zależności od położenia ceny względem wybranych średnich (np. EMA 50, SMA 500).

2) W ustawieniach pluginu Moving Averages [psyll] twórz swoją konfiguracje średniej kroczącej:

3) przejdź do ustawień Pine Algo [psyll] i otwórz sekcję Entry Plugins.

4) W polu Source wybierz sygnał z pluginu Moving Averages [psyll], np. Above/Below Price. Dzięki temu Pine Algo będzie otwierać pozycje tylko wtedy, gdy cena znajduje się po właściwej stronie średnich kroczących - czyli zgodnie z trendem..