# Webhooki goodcryptoX pozwala na automatyzację działań handlowych za pomocą webhooków TradingView — potężnego mechanizmu uruchamiania zleceń i akcji botów bezpośrednio z twoich sygnałów. W przeciwieństwie do niektórych implementacji traktujących webhooki jak programowalne API (gdzie wysyłasz parametryzowane polecenia typu "kup 3 BTC"), goodcryptoX obecnie wspiera model oparty na triggerach. Każdy webhook jedynie aktywuje zdefiniowaną wcześniej akcję na konkretnym zleceniu lub bocie — żadne parametry ani polecenia nie są interpretowane. W niedalekiej przyszłości uruchomimy nowy [bot strategii TradingView](/goodcryptox-pl/dex-y-perp/nadchodzace-funkcje/bot-strategii-tradingview.md) który będzie obsługiwał pełne instrukcje strategii przez webhooki, w tym dynamiczny wybór instrumentu, ilości, typy zleceń i logikę wieloinstrumentową — działając efektywnie jako warstwa API. Bądź na bieżąco > Na razie webhooki są akceptowane wyłącznie z serwerów TradingView — brak niestandardowych adresów IP lub zewnętrznych źródeł.\ > Jeśli potrzebujesz użyć niestandardowego źródła webhooków, skontaktuj się z nami pod aby poprosić o dostęp. ### Jak działają webhooki w goodcryptoX * Każde zlecenie lub bot **akcja** ma własny dedykowany URL webhooka * Musisz najpierw utworzyć zlecenie lub bota, aby otrzymać URL (pojawią się w **Webhooki** sekcji szczegółów zlecenia lub bota **Szczegóły**) * Wysłanie **dowolnego** ładunku webhooka na ten URL uruchomi akcję > URL-e webhooków są specyficzne dla akcji, a nie dla użytkownika. Musisz utworzyć jeden webhook na akcję, np. jeden dla wejścia, jeden dla take profit, jeden dla stop loss itd. dla każdego bota lub zlecenia ### Obsługiwane akcje zleceń i botów Jeśli chcesz, aby twoje zlecenie lub bot było **uruchamiane przez webhook**, musisz wybrać webhook jako **warunek wyzwalający podczas konfiguracji**. To dotyczy: * Zlecenia stop-market / stop-limit wyzwalają * Aktywacja zleceń trailing (początek trailing) * Wyzwalacze take-profit i stop-loss * Warunek wejścia bota DCA
Po utworzeniu znajdziesz wszystkie dostępne URL-e webhooków w **Szczegóły** szczegółach twojego zlecenia lub bota:
> **Anuluj** webhook — zawsze dostępny we wszystkich zleceniach i botach > > **Zamknij pozycję** webhook — zawsze dostępny w szczegółach bota DCA Podsumowując: | Akcja | Obsługiwane? | Notatki | | ------------------------------- | ------------ | ------------------------------------------------------------------------------- | | Anuluj zlecenie | ✅ | Zawsze widoczne w szczegółach | | Wywołaj zlecenie Stop | ✅ | Należy wybrać webhook przy konfiguracji | | Aktywuj zlecenie Trailing | ✅ | Początek trailing = webhook | | Wywołaj take profit / stop loss | ✅ | Opcjonalnie wyzwalane przez webhook | | Bot DCA - wejście | ✅ | Wejście kupna/sprzedaży przez webhook (musi być ustawione podczas konfiguracji) | | Bot DCA - wyjście | ✅ | Zamknięcie pozycji przez webhook (zawsze dostępne) | | Bot Grid - wejście | 🚫 | Jeszcze nieobsługiwane | {% hint style="info" %} **Wiele celów take-profit poprzez webhooki** Jeśli skonfigurujesz grupę take-profit używając webhooka jako metody wyzwalania, wszystkie będą dzielić ten sam URL webhooka. Za każdym razem, gdy webhook zostanie wywołany, wykona się następne zamówienie TP w sekwencji — jedno po drugim. {% endhint %} ### Jak skonfigurować alerty w TradingView Gdy utworzysz swoje zlecenie lub bota w goodcryptoX i skopiujesz URL webhooka dla konkretnej akcji, oto jak powiązać go z alertami TradingView: 1. Przejdź do wykresu w TradingView 2. Utwórz nowy alert na podstawie swojej strategii, wskaźnika lub warunku 3. W **ustawieniach alertu**, zaznacz pole wyboru **„Webhook URL”** 4. Wklej konkretny URL webhooka z sekcji Webhooki w goodcryptoX 5. Pozostaw **pole wiadomości** bez zmian (dowolna zawartość jest w porządku — goodcryptoX na razie ignoruje payload) 6. Zapisz alert ### Powtarzające się strategie (przez bota DCA) Zlecenie wyzwalane webhookiem (np. stop-market z TP i SL) to **jednorazowa konfiguracja**. Po wykonaniu zlecenia i uruchomieniu powiązanego TP lub SL, cała transakcja jest zakończona. Jeśli chcesz, aby ta struktura **powtarzała się automatycznie**, nie jest to możliwe w przypadku zleceń — ale jest osiągalne teraz przy użyciu bota DCA. Wkrótce wprowadzimy dedykowany [bot strategii TradingView](/goodcryptox-pl/dex-y-perp/nadchodzace-funkcje/bot-strategii-tradingview.md) aby wspierać powtarzające się transakcje wieloetapowe, ale w międzyczasie bot DCA daje elastyczny sposób powtarzania strategii uruchamianej przez webhooky. #### Czysta pętla webhooków Aby ustawić bota, który wchodzi w pozycję na webhook, wychodzi na webhook, a następnie powtarza: 1. Ustaw **warunek wejścia** = webhook 2. Ustaw **zlecenia uśredniające** = 0 (wyłącz uśrednianie) 3. Wyłącz oba **take**-**profit** i **stop-loss** 4. Włącz **"Powtarzaj przy zamknięciu pozycji"**
Po uruchomieniu bota zobaczysz następujące URL-e webhooków w sekcji **Szczegóły → Webhooki** bota: * **Wejdź Kupno** — otwiera pozycję Long * **Wejdź Sprzedaż** — otwiera pozycję Short * **Zamknij pozycję** — zamyka aktywną pozycję (long lub short) * **Anuluj** — zatrzymuje bota **Logika wykonania** * Gdy bot otrzyma **Wejdź Kupno**, otwiera pozycję long. * Gdy otrzyma **Wejdź Sprzedaż**, otwiera pozycję short. * Bot będzie **odpowiadać tylko na pierwszy webhook wejścia** który otrzyma, będąc bezczynny. * Gdy pozycja jest otwarta: * Wszystkie dalsze sygnały wejścia są **ignorowane** * Bot nie zwiększy ani nie odwróci obecnej pozycji na sygnały wejścia * Jedynymi akceptowanymi sygnałami są **zamknięcie pozycji** lub wywołane TP/SL (jeśli skonfigurowane) * Gdy pozycja zostanie zamknięta (ręcznie, przez webhook lub przez SL/TP), bot się resetuje i czeka na następny webhook wejścia. Ta pętla trwa dopóki bot pozostaje aktywny, pozwalając powtarzać cykl wejście → wyjście → reset w nieskończoność. #### Tryb czystego webhooka vs konfiguracje hybrydowe Bot DCA obsługuje wiele warstw kontroli, które można łączyć, aby budować elastyczne strategie: * **Wejście**: przez webhook, sygnał lub asap * **Wyjście**: przez webhook lub wbudowane TP/SL oparte na cenie * **Uśrednianie**: opcjonalne; można wyłączyć Możesz: * Uruchomić bota całkowicie za pomocą sygnałów webhook (wejście i wyjście) * Dodać TP/SL oparte na cenie jako zabezpieczenie, nawet jeśli używasz wyjść przez webhook * Dodać zlecenia uśredniające dla dodatkowej ochrony To umożliwia zaprojektowanie: * W pełni zautomatyzowanych strategii pętlowych (czysty webhook) * Botów sterowanych sygnałem z ręcznymi zabezpieczeniami * Konfiguracji hybrydowych z wielowarstwowymi wyjściami ### Praktyczne przykłady strategii z webhookami #### Przykład 1: Jednorazowe zlecenie + wiele take profit (odbicie od wstęgi Bollingera) **Cel:** Kupić gdy cena przebije dolną wstęgę Bollingera, sprzedawać stopniowo w miarę wzrostu. **Konfiguracja w goodcryptoX** * Utwórz zlecenie stop-market z warunkiem wyzwalającym = webhook * Dodaj trzy cele take-profit. Wyzwalacz TP = webhook
**Konfiguracja w TradingView** Utwórz cztery alerty: 1. Cena przebija dolną wstęgę → wyślij do głównego zlecenia **Wyzwalacz** URL webhooka 2. Cena wraca do wnętrza wstęgi → wyślij do **Wyzwalacza Take Profit** URL webhooka 3. Cena przecina środkową wstęgę → wyślij do **Wyzwalacza Take Profit** URL webhooka 4. Cena przebija górną wstęgę → wyślij do **Wyzwalacza Take Profit** URL webhooka
W **ustawieniach alertu**, zaznacz pole wyboru **„Webhook URL”** Wklej konkretny URL webhooka z sekcji Webhooki w goodcryptoX. Pozostaw pole Wiadomości bez zmian — nie jest używane. #### Przykład 2: Powtarzająca się strategia z botem DCA (Golden/Death Cross) **Cel:** Wejdź long przy Golden Cross, wejdź short przy Death Cross. Wyjdź z 10% zyskiem lub kiedy RSI > 70 i powtarzaj w nieskończoność. **Konfiguracja w goodcryptoX** Utwórz bota DCA * Warunek wejścia = webhook * Uśrednianie = wyłączone (ustaw na 0) * Take Profit = 10% * Stop loss = wyłączony * Włącz: "Powtarzaj przy TP" **Konfiguracja w TradingView** * Utwórz trzy alerty na tym samym wykresie: 1. SMA50 przecina powyżej SMA200 → wyślij do **Wejdź Kupno** webhooka 2. SMA50 przecina poniżej SMA200 → wyślij do **Wejdź Sprzedaż** webhooka 3. RSI > 70 → wyślij do **Zamknij pozycję** webhooka {% hint style="info" %} Bot DCA utrzymuje tylko jedną pozycję naraz. Podczas trwania pozycji ignoruje nowe webhooki wejścia aż do zamknięcia pozycji. Jeśli chcesz móc równolegle otwierać pozycje Long i Short na tym samym instrumencie — utwórz dwa oddzielne boty i wyślij Wejdź Kupno do jednego, a Wejdź Sprzedaż do drugiego {% endhint %} ### Podsumowanie | Koncepcja | Opis | | -------------------------- | -------------------------------------------------------------------- | | Model wyzwalania | Każda akcja ma własny URL webhooka | | Przebieg konfiguracji | Utwórz zlecenie → skopiuj URL webhooka → wklej do alertu TradingView | | Powtarzająca się strategia | Użyj bota DCA z włączonym powtarzaniem | ### Samouczki wideo #### **Wprowadzenie do handlu webhookami** {% embed url="" %} #### **Używanie bota DCA z webhookami** {% embed url="" %} #### **Wiele take-profits przez webhooki** {% embed url="" %} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.goodcrypto.app/goodcryptox-pl/dex-y-perp/webhooki.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.