Dokumentacja - Panel zarządzania webhookiem

Panel zarządzania webhookiem stanowi centralne miejsce w Twoim Panelu Handlowym, umożliwiające pełną kontrolę, konfigurację oraz monitorowanie każdego webhooka. Jest to zaawansowane narzędzie, które pozwala na dostosowanie ustawień, bieżące śledzenie aktywności oraz analizę odpowiedzi systemu i giełdy. Dzięki temu użytkownicy zyskują pewność, że ich zlecenia są realizowane zgodnie z założeniami, a proces automatyzacji transakcji przebiega płynnie i efektywnie.

Panel zarządzania webhookiem dostępny jest dla zalogowany użytkowników Konto handlowe > Moje webhooki > Wybierz Webhook

1/3

2/3

3/3

W tym miejscu użytkownicy mogą nie tylko zarządzać pojedynczym webhookiem, ale także monitorować wszystkie odpowiedzi i logi w jednym, wygodnym interfejsie. Dzięki temu proces automatyzacji handlu, testowania i analiza odpowiedzi staje się bardziej przejrzysty, efektywny i dostosowany do potrzeb użytkownika.

Kluczowe Informacje

W górnej części panelu zarządzania webhookiem prezentowane są podstawowe dane, które umożliwiają szybki przegląd stanu i konfiguracji webhooka.

Informacje te obejmują:

Status: Wskazuje, czy webhook jest aktywny (włączony) i gotowy do przyjmowania oraz przetwarzania sygnałów, czy też nieaktywny (wyłączony). Pozwala to użytkownikowi na bieżąco ocenić gotowość webhooka do działania.
Nazwa: Umożliwia łatwą identyfikację webhooka, co jest szczególnie przydatne w przypadku korzystania z wielu webhooków jednocześnie. Nazwa powinna być intuicyjna i jednoznaczna.
Giełda: Informuje, na której platformie handlowej działa webhook, np. Binance SPOT, MEXC SPOT czy inne obsługiwane giełdy.
Unikalny Identyfikator (ID): Kluczowy parametr wykorzystywany w adresie URL do wysyłania żądań do webhooka. Jest to unikatowy ciąg znaków zapewniający bezpieczne i precyzyjne kierowanie sygnałów.
Kod: Unikalny kod, który musi zostać uwzględniony w treści żądania, aby system zaakceptował i przetworzył zlecenie. Gwarantuje to dodatkowe zabezpieczenie przed nieautoryzowanym dostępem.
Limit dzienny: Wyświetla liczbę już wykonanych wywołań webhooka w danym dniu oraz maksymalny limit wywołań dostępny dla Twojego konta. Użytkownicy posiadający konto PRO korzystają z wyższych limitów w porównaniu do użytkowników darmowego planu.
Zaokrąglanie ilości: Informuje, czy system automatycznie zaokrągla ilości quantity zlecenia oraz do ilu miejsc po przecinku (jeśli opcja jest włączona) lub czy zaokrąglanie jest wyłączone, co pozwala na zachowanie pełnej precyzji przesłanych danych.

Te dane zapewniają użytkownikowi szybki wgląd w podstawową konfigurację webhooka.

Dziennik handlowy - Monitorowanie aktywności

Kluczowym elementem panelu zarządzania webhookiem jest szczegółowy dziennik handlowy (log), który rejestruje wszystkie aktywności związane z webhookiem.

Dziennik ten umożliwia bieżące monitorowanie:

Utworzono: Precyzyjna data i godzina złożenia zlecenia, co pozwala na dokładne śledzenie chronologii działań.
Status: Informacja, czy zlecenie zostało wykonane pomyślnie, odrzucone, czy napotkało inne problemy.
Akcja: Określa typ zlecenia, BUY, SELL lub SET
Symbol: Symbol pary aktywów (np. BTCUSDT), którego dotyczy zlecenie.
Ilość : Ilość jednostek kupowanych lub sprzedawanych w ramach zlecenia.
Odpowiedź: Komunikaty zwrotne od giełdy, które mogą zawierać potwierdzenie realizacji zlecenia, informacje o błędach, przekroczeniu limitów lub innych istotnych zdarzeniach.

Zapytanie webhook

Sekcja Zapytanie "webhooka" prezentuje podstawowe informacje potrzebne do wysyłania sygnałów do systemu za pomocą webhooków. Wyświetlany jest w niej unikalny adres URL webhooka, przypisany do danego użytkownika, który należy wykorzystać w integracjach zewnętrznych systemów, botów lub platform sygnałowych.

Dodatkowo sekcja zawiera proste przykłady kodu, pokazujące w jakim formacie należy przekazać dane - zarówno w formie żądania HTTP POST, jak i komunikatu alertu (np. z TradingView). Dzięki temu użytkownik może szybko skopiować adres i strukturę danych, a następnie wykorzystać je w swoim środowisku automatyzacji lub strategii handlowej, bez konieczności zagłębiania się w pełną dokumentację.

1/2

2/2

Jeśli webhook nie został jeszcze użyty do realizacji zleceń, w dzienniku pojawi się komunikat informujący o braku historii aktywności. Dziennik handlowy jest nieocenionym narzędziem do analizy i weryfikacji poprawności działania automatyzacji, umożliwiając szybkie wykrywanie i korygowanie potencjalnych problemów.

Zarządzanie webhookiem

Panel zarządzania webhookiem oferuje intuicyjne opcje umożliwiające pełną kontrolę nad webhookiem.

Dostępne funkcje obejmują:

Edytuj ustawienia: Przycisk przenosi użytkownika do formularza, w którym można zmodyfikować us6tawienia webhooka.
Wyczyść log: Funkcja umożliwia usunięcie całej historii wywołań i odpowiedzi webhooka, co jest przydatne w przypadku konieczności rozpoczęcia monitorowania od nowa lub uporządkowania panelu.
Usuń webhooka: Pozwala na trwałe usunięcie webhooka z systemu, co również wymaga potwierdzenia, aby zapobiec przypadkowemu usunięciu.
Wróć do listy: Umożliwia szybkie przejście do widoku wszystkich webhooków, gdzie użytkownik może wybrać inny webhook lub dodać nowy.

Ustawienia webhooka

Strona ustawień webhooka umożliwia szczegółowe dostosowanie parametrów do wymagań użytkownika. Wszystkie zmiany wprowadzone są natychmiast po zatwierdzeniu i mają bezpośredni wpływ na sposób, w jaki webhook przetwarza sygnały handlowe.

Dostępne opcje konfiguracyjne obejmują:

Nazwa webhooka

W tym polu użytkownik może nadać webhookowi unikalną nazwę ułatwiającą jego identyfikację w panelu.

Wymagania: Dozwolone są litery, cyfry, spacje oraz myślniki. Długość nazwy musi wynosić od 3 do 24 znaków.
Przykłady: "BTC-ScalperBot", "ETH-SpotWebhook-01". Czytelna nazwa znacząco ułatwia zarządzanie, szczególnie przy korzystaniu z wielu webhooków obsługujących różne strategie handlowe.

Status Webhooka

Użytkownik może określić, czy webhook ma być aktywny:

Włączony (Enabled): Webhook przyjmuje i przetwarza żądania, umożliwiając realizację zleceń na giełdzie.
Wyłączony (Disabled): Webhook jest tymczasowo wstrzymany i nie reaguje na sygnały.

Wyłączenie webhooka jest przydatne podczas testowania strategii, analizy wyników lub chwilowego zawieszenia handlu.

Zaokrąglanie Ilości (Quantity Decimal Rounding)

Opcja ta pozwala na kontrolę precyzji ilości instrumentów w zleceniach:

Włączone (Enabled): Użytkownik określa liczbę miejsc po przecinku (od 0 do 16), do której system zaokrągla ilości. Na przykład, dla sygnału z ilością 0,012345 i ustawieniem na 2 miejsca po przecinku, system zaokrągli wartość do 0.01.
Wyłączone (Disabled): System zachowuje dokładną wartość przesłaną w sygnale, bez zaokrąglania.

Funkcja ta jest kluczowa dla zapewnienia zgodności z wymaganiami giełd dotyczącymi precyzji wolumenu transakcji.

Po wprowadzeniu zmian użytkownik może zapisać ustawienia. Zmiany są stosowane natychmiast, a użytkownik może w dowolnym momencie powrócić do panelu ustawień, aby dokonać dalszych modyfikacji.

Dlaczego warto korzystać z panelu zarządzania webhookiem?

Panel zarządzania webhookiem został zaprojektowany, aby zapewnić użytkownikom maksymalną kontrolę i wygodę w automatyzacji transakcji, testowaniu oraz śledzeniu zapytań. Kluczowe korzyści płynące z jego użytkowania to:

Pewność działania: Pełny wgląd w proces realizacji zleceń, umożliwiający weryfikację, czy sygnały docierają do giełdy i są prawidłowo przetwarzane.
Szybka reakcja na problemy: Dziennik handlowy pozwala na błyskawiczne wykrywanie błędów, takich jak przekroczenie limitów czy niepoprawne sygnały, co umożliwia szybkie wprowadzenie korekt.
Prosta konfiguracja: Wszystkie ustawienia i parametry są dostępne w przejrzystym interfejsie, co ułatwia dostosowanie webhooka do indywidualnych potrzeb.