Wprowadzenie do webhooków

Webhooki na platformie Psyll to zaawansowane i niezwykle efektywne narzędzie, które umożliwia automatyzację handlu kryptowalutami poprzez bezpośrednią integrację zewnętrznych systemów, aplikacji i skryptów. Dzięki webhookom możesz w czasie rzeczywistym przesyłać sygnały handlowe bezpośrednio na swoje konto giełdowe, co pozwala na automatyczne otwieranie, zamykanie lub modyfikowanie pozycji zgodnie z Twoimi strategiami, bez konieczności ręcznego logowania i składania zleceń.

Webhook to unikalny adres URL (endpoint), na który wysyłane są zapytania HTTP POST zawierające dane dotyczące określonych akcji handlowych, takich jak kupno, sprzedaż, ustawienie zlecenia limitowego, czy anulowanie zamówienia. Po odebraniu zapytania platforma Psyll weryfikuje i przetwarza dane, a następnie wykonuje odpowiednie polecenia na wybranej giełdzie z wykorzystaniem kluczy API przypisanych do Twojego konta.

Dzięki kompatybilności z popularnymi narzędziami, takimi jak TradingView, możesz w prosty sposób powiązać alerty z generowaniem zleceń. Wystarczy w ustawieniach alertu podać adres URL webhooka oraz treść zapytania, aby Twoja strategia z TradingView automatycznie wywoływała operacje w Psyll.

Twoje webhooki możesz znaleść w Konto handlowe > Moje webhooki

1/2

2/2

Przebieg działania

Działanie webhooka na platformie Psyll można podzielić na cztery logiczne etapy, które razem tworzą kompletny proces automatyzacji transakcji. Każdy z tych etapów odgrywa kluczową rolę w zapewnieniu płynnej i bezpiecznej komunikacji pomiędzy Twoim systemem a giełdą.

Proces rozpoczyna się w panelu użytkownika, gdzie tworzysz nowy webhook, nadając mu unikalną nazwę, wybierając giełdę oraz powiązując go z odpowiednimi kluczami API. Po zapisaniu konfiguracji webhook otrzymuje indywidualny identyfikator, unikalny adres URL oraz kod dostępu, które stanowią punkt wejścia do systemu. Dane te należy przechowywać w bezpiecznym miejscu, ponieważ umożliwiają bezpośrednie przesyłanie sygnałów do Twojego konta.

Kolejnym etapem jest wysyłanie zapytań. Może się to odbywać z poziomu własnego skryptu, aplikacji, platformy zewnętrznej czy narzędzia analitycznego, takiego jak TradingView. Zapytania HTTP POST kierowane są na indywidualny adres webhooka i zawierają w treści szczegóły dotyczące transakcji, takie jak rodzaj akcji, symbol instrumentu oraz ilość. Dzięki temu Psyll wie, jakie zlecenie powinno zostać wykonane, na jakim rynku i w jakiej skali.

Po odebraniu sygnału system Psyll przeprowadza weryfikację poprawności danych oraz autoryzację zapytania. Następnie sprawdza, czy w ramach Twojego planu subskrypcyjnego dostępne są odpowiednie limity, a jeśli tak - przekazuje zlecenie do wybranej giełdy poprzez powiązane API. W odpowiedzi Psyll zwraca dane w formacie JSON, zawierające informację o statusie operacji, czasie realizacji, parametrach zlecenia, szczegółach jego wykonania oraz aktualnym stanie wykorzystania limitów.

Ostatnim elementem jest monitorowanie i raportowanie. Wszystkie przesłane zapytania oraz otrzymane odpowiedzi są zapisywane w logach dostępnych w panelu Psyll. Umożliwia to przeglądanie historii operacji, analizowanie skuteczności automatyzacji, kontrolowanie limitów oraz sprawdzanie surowych odpowiedzi z giełdy, co jest szczególnie przydatne w przypadku diagnozowania ewentualnych problemów. Dzięki temu cały proces jest przejrzysty i w pełni udokumentowany, co pozwala na skuteczne zarządzanie integracją i szybką reakcję w razie potrzeby.

Zapytania do webhooka

Webhooki na platformie Psyll działają na podstawie zapytań HTTP POST przesyłanych na unikalny adres URL. Każde zapytanie powinno zawierać poprawnie sformatowane dane, który precyzyjnie określa, jaką akcję ma wykonać system na giełdzie.

Przykładowy URL:

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

Dane POST:

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

Szczegółów na temat budowy zapytań webhook możesz znaleźć w dokumentacji "Tworzenie zapytania webhook"

Odpowiedź serwera

Po przetworzeniu zapytania, serwer Psyll zwraca odpowiedź w formacie JSON, która zawiera wszystkie istotne informacje dotyczące wykonanego zlecenia oraz status jego realizacji.

Przykładowa odpowiedź może wyglądać następująco:

"created": "2025-08-12 18:12:35",
"limit": {
    "account": "PRO",
    "max_per_day": 100,
    "usage": 56
},
"message": "Order executed",
"request": {
    "action": "SET",
    "code": "{WEBHOOK-CODE}",
    "quantity": " 0.01",
    "symbol": "BTCUSDT"
},
"status": "success",
"response": {
    //Exchange response
}

W odpowiedzi znajdziesz m.in.:

Dzięki takiemu mechanizmowi możesz w prosty sposób monitorować skuteczność swoich sygnałów i mieć pełną kontrolę nad automatycznym handlem.

Szczegółów na temat odpowiedzi webhook możesz znaleźć w dokumentacji "Odpowiedź webhooka"

Limity i plany subskrypcji

Dostęp do webhooków, a także liczba możliwych zapytań i aktywnych endpointów, zależą od Twojego planu subskrypcji:

Więcej o limitach możesz dowiedzieć się w dokumentacji "Limity"

Integracja z TradingView

Webhooki w Psyll można w prosty sposób połączyć z alertami w TradingView, co pozwala automatycznie realizować zlecenia na giełdzie w oparciu o sygnały generowane przez Twoje strategie lub wskaźniki. Dzięki temu nie musisz ręcznie reagować na każdy sygnał — operacje wykonywane są natychmiast po spełnieniu określonych warunków w TradingView.

Psyll umożliwia pełną integrację webhooków z systemem alertów w TradingView, dzięki czemu użytkownicy mogą łączyć swoje strategie inwestycyjne z natychmiastową realizacją zleceń na giełdzie. TradingView jest jednym z najpopularniejszych narzędzi do analizy technicznej i tworzenia niestandardowych strategii, a połączenie go z Psyll pozwala w pełni zautomatyzować proces podejmowania decyzji i wykonywania transakcji.

Po wygenerowaniu unikalnego adresu webhooka w panelu Psyll, można go użyć w konfiguracji alertów w TradingView jako docelowego punktu wysyłki sygnałów. Gdy strategia lub wskaźnik w TradingView wygeneruje sygnał kupna, sprzedaży czy innej akcji, zostanie on automatycznie wysłany do Psyll w formie zapytania HTTP. Psyll odbiera te dane, przetwarza je i natychmiast przekazuje odpowiednie instrukcje na konto giełdowe użytkownika, wykorzystując przypisane wcześniej klucze API.

Cały proces odbywa się w czasie rzeczywistym — od momentu pojawienia się sygnału w TradingView do realizacji zlecenia na giełdzie mijają zazwyczaj ułamki sekund. Dzięki temu integracja jest idealnym rozwiązaniem dla traderów, którzy chcą reagować na zmiany rynkowe natychmiast, eliminując opóźnienia wynikające z manualnego składania zleceń.

Przykładowe kody aplikacji

Przykłady użycia webhooków w różnych językach programowania (m.in. Bash, JavaScript, Python, PHP) dostępne są w naszej dokumentacji "Przykłady użycia dla różnych języków programowania"

Znajdziesz tam gotowe fragmenty kodu, które możesz skopiować i natychmiast wykorzystać w swojej aplikacji, aby wysyłać zapytania do webhooków Psyll.

GitHub

Oficjalne repozytoria, biblioteki i materiały pomocnicze znajdziesz na naszym GitHubie:  https://github.com/psyll