Dokumentacja - Integracja alertow Tradingview

Integracja alertów TradingView z systemem webhooków Psyll pozwala na automatyczne przesyłanie sygnałów handlowych z platformy TradingView do systemu obsługującego webhook. Dzięki temu użytkownicy mogą w czasie rzeczywistym realizować zlecenia handlowe na giełdzie, bez konieczności ręcznego wprowadzania decyzji. Rozwiązanie to zwiększa precyzję i szybkość reakcji, umożliwia pełną automatyzację strategii handlowych oraz minimalizuje ryzyko opóźnień w realizacji zleceń. Niniejszy dokument szczegółowo opisuje proces konfiguracji webhooka, przedstawia przykłady praktycznych zastosowań, w tym wykorzystanie placeholderów do dynamicznego dopasowania strategii, oraz zawiera wskazówki i najlepsze praktyki wspierające efektywną automatyzację handlu.

Unikalny adres URL webhooka

Każdy webhook w systemie Psyll posiada unikalny adres URL w następującym formacie:

ttps://psyll.com/env/webhook/{WEBHOOK-ID}

Adres URL należy wprowadzić w polu Webhook URL w ustawieniach alertu TradingView, w sekcji Notifications. Unikalny identyfikator {WEBHOOK-ID} generowany jest wraz z tworzeniem nowego webhooka w panelu zarządzania webhookami w systemie Psyll.

Ważne jest, aby kopiować go dokładnie, gdyż najmniejszy błąd w adresie może uniemożliwić prawidłowe przesyłanie sygnałów.

Wskazówki praktyczne:

Sprawdź dwukrotnie, czy nie ma spacji na początku lub końcu adresu URL.
Zawsze używaj najnowszego, aktywnego ID webhooka, zwłaszcza jeśli generujesz nowe sesje testowe.

Unikalny URL pozwala systemowi Psyll dokładnie zidentyfikować źródło alertu i przypisać sygnał do odpowiedniego webhooka.

Integracja z alertami TradingView

Integracja webhooka z alertami platformy TradingView umożliwia elastyczne dostosowanie alertów do różnorodnych strategii handlowych oraz dynamicznych warunków rynkowych. Alerty można konfigurować na podstawie ręcznie zdefiniowanych warunków, takich jak przekroczenie określonego poziomu ceny, wzrost ceny, spadek ceny, ruch w górę lub ruch w dół, zmiana wolumenu, bądź w powiązaniu ze strategiami napisanymi w języku Pine Script, co pozwala na bardziej zaawansowaną automatyzację handlu. Taka elastyczność wspiera zarówno proste, ręczne alerty, jak i złożone strategie algorytmiczne, dostosowując się do indywidualnych potrzeb użytkownika.

Aby skonfigurować alert TradingView, należy wykonać następujące kroki:

Przejdź do sekcji Alerts w TradingView i kliknij ikonę +, aby utworzyć nowy alert.

W polu Condition wybierz warunek wyzwalający alert, np. przekroczenie poziomu ceny, zmiana wolumenu, ruch w górę lub w dół, lub nazwę strategii Pinescript.

W sekcji Notifications, w polu Webhook URL, wklej unikalny adres URL webhooka uzyskany w panelu Psyll.

W polu Message wprowadź treść wiadomości w formacie JSON, która będzie określać działanie webhooka w odpowiedzi na sygnał.

Pole Message w alertach TradingView służy do przekazywania szczegółowych instrukcji do webhooka systemu Psyll. Wiadomości w formacie JSON umożliwiają pełną kontrolę nad działaniami automatyzacji handlu na wybranej giełdzie, w tym określenie akcji, ilości oraz symbolu instrumentu. Każda wiadomość JSON musi zawierać unikalny kod webhooka {WEBHOOK-CODE}, który identyfikuje alert w systemie Psyll, oraz odpowiednie parametry, takie jak:

action: określa typ operacji (np. SET, BUY, SELL).
quantity: określa ilość aktywa bazowego do sprzedaży lub zakupu
symbol: określa instrument finansowy (np. BTCUSDC).

Poniżej przedstawiono przykłady typowych operacji, które można zautomatyzować za pomocą wiadomości JSON, wraz z wyjaśnieniem ich działania.

Ustawienie dokładnego salda portfela

Jeśli użytkownik chce, aby saldo portfela wynosiło dokładnie określoną ilość aktywa (np. 0.1 BTC) po wystąpieniu sygnału, system Psyll automatycznie dostosowuje stan portfela:

Jeśli saldo jest większe niż docelowe (np. 0.1 BTC), system sprzeda nadwyżkę, aby wyrównać stan portfela.
Jeśli saldo jest mniejsze niż docelowe, system dokupi brakującą ilość.

Przykładowa wiadomość JSON dla tej operacji:

{
    "code": "{WEBHOOK-CODE}",
    "action": "SET",
    "quantity": "0.1",
    "symbol": "BTCUSDC"
}

Zakup określonej ilości po sygnale

W scenariuszu, w którym użytkownik chce zakupić określoną ilość kryptowaluty po wystąpieniu sygnału, stosuje się akcję BUY. Na przykład, aby kupić 0.01 BTC za USDC, wiadomość JSON wygląda następująco:

{
   "code": "{WEBHOOK-CODE}",
   "action": "BUY",
   "quantity": "0.01",
   "symbol": "BTCUSDC"
}

Ta operacja jest przydatna w strategiach opartych na sygnałach kupna, umożliwiając natychmiastową reakcję na pozytywne warunki rynkowe.

Sprzedaż określonej ilości po sygnale

Analogicznie, aby sprzedać określoną ilość kryptowaluty po wystąpieniu sygnału, stosuje się akcję SELL. Przykładowa wiadomość JSON dla sprzedaży 0.01 BTC za USDC:

{
   "code": "{WEBHOOK-CODE}",
   "action": "SELL",
   "quantity": "0.01",
   "symbol": "BTCUSDC"
}

Ta akcja wspiera strategie zabezpieczające, pozwalając na szybką realizację zysków lub minimalizację strat.

Budowa automatycznych strategii z użyciem placeholderów

Platforma TradingView umożliwia korzystanie z placeholderów w polu Message, co pozwala na dynamiczne wstawianie danych z wykresu lub strategii Pine Script bezpośrednio do wiadomości JSON. Dzięki temu użytkownicy mogą automatycznie przekazywać informacje takie jak symbol instrumentu, wielkość pozycji, typ akcji czy aktualny stan strategii, bez potrzeby ręcznego wpisywania tych wartości. Placeholdery w pełni wspierają automatyzację strategii, umożliwiając dostosowanie działania botów do bieżących danych rynkowych i sygnałów generowanych przez algorytm w czasie rzeczywistym.

Na przykład, w scenariuszu, w którym użytkownik chce, aby saldo portfela było zgodne z aktualną pozycją określoną przez strategię Pine Script, a symbol instrumentu był pobierany automatycznie z wykresu, wiadomość JSON może wyglądać następująco:

{
    "code": "{WEBHOOK-CODE}",
    "action": "BUY",
    "quantity": "{{strategy.position_size}}",
    "symbol": "BTCUSDC"
}

W tym przypadku placeholder {{strategy.position_size}} dynamicznie pobiera wielkość pozycji zdefiniowaną w strategii Pine Script, natomiast symbol BTCUSDC może być również zastąpiony placeholderem {{ticker}} w przypadku, gdy chcemy, aby webhook działał dla dowolnej pary instrumentów z wykresu. Taka konfiguracja pozwala na pełną automatyzację handlu, umożliwiając precyzyjne dopasowanie salda portfela do sygnałów strategii. Każde zlecenie generowane przez strategię jest natychmiast odzwierciedlane w systemie, co eliminuje opóźnienia i ryzyko błędów wynikających z ręcznej interwencji.

Dodatkowo można wykorzystać placeholdery dla samego typu akcji (action) generowanej przez strategię Pine Script. Wstawiając {{strategy.order.action}}, webhook automatycznie pobiera informacje, czy strategia zaleca zakup czy sprzedaż. W połączeniu z placeholderem {{strategy.order.contracts}}, który określa liczbę jednostek instrumentu, oraz {{ticker}} określającym symbol instrumentu, system przesyła dokładnie te zlecenia, które są wywoływane w strategii, zapewniając pełną synchronizację z dynamicznymi decyzjami algorytmu. Przykładowa wiadomość JSON może wyglądać tak:

{
    "code": "4RLP9KZeMzPppeKK",
    "action": "{{strategy.order.action}}",
    "quantity": "{{strategy.order.contracts}}",
    "symbol": "{{ticker}}"
}

Dzięki takiej konfiguracji każdy sygnał generowany w Pine Script jest automatycznie odwzorowywany przez bota handlowego, co pozwala na natychmiastowe reagowanie na zmieniające się warunki rynkowe, pełną automatyzację procesu handlowego oraz optymalizację wykorzystania środków w portfelu. Zastosowanie placeholderów eliminuje konieczność ręcznej modyfikacji zleceń i umożliwia łatwe skalowanie strategii na różne instrumenty finansowe bez zmiany konfiguracji webhooka.

Najlepsze praktyki i wskazówki

Podczas konfiguracji integracji kluczowe jest zapewnienie poprawności kodu webhooka {WEBHOOK-CODE} oraz identyfikatora {WEBHOOK-ID}, które należy dokładnie skopiować z panelu zarządzania webhookiem, aby uniknąć błędów w komunikacji. Przed aktywacją alertu na koncie rzeczywistym zaleca się przetestowanie go na koncie demonstracyjnym, co pozwala zweryfikować poprawność konfiguracji i działania webhooka. Symbol podany w wiadomości JSON, na przykład BTCUSDC, powinien być zgodny z formatem używanym na giełdzie, z którą zintegrowany jest webhook. Regularne monitorowanie dziennika handlowego w panelu zarządzania webhookiem umożliwia weryfikację, czy zlecenia są realizowane zgodnie z założeniami. Unikalny kod webhooka i identyfikator należy przechowywać w bezpiecznym miejscu, aby zapobiec nieautoryzowanemu dostępowi.

Podsumowanie

Integracja alertów TradingView z webhookiem stanowi zaawansowane narzędzie do automatyzacji strategii handlowych, oferując wysoką precyzję i elastyczność. Poprzez odpowiednią konfigurację adresu URL, kodu JSON oraz wykorzystanie placeholderów TradingView, użytkownicy mogą efektywnie realizować zlecenia kupna, sprzedaży lub dostosowania salda portfela w oparciu o warunki rynkowe lub sygnały strategii Pine Script. Połączenie panelu zarządzania webhookiem z platformą TradingView zapewnia pełną kontrolę nad procesem, umożliwiając szybką reakcję na zmiany rynkowe i optymalizację działań handlowych, co jest szczególnie cenne dla użytkowników poszukujących pełnej automatyzacji w prywatnych botach handlowych.