# Webhooki goodcryptoX pozwala automatyzować działania handlowe za pomocą webhooków TradingView — potężnego mechanizmu wywoływania zleceń i akcji bota bezpośrednio z Twoich sygnałów. W przeciwieństwie do niektórych implementacji, które traktują webhooki jak programowalne API (gdzie wysyłasz parametryzowane polecenia typu "kup 3 BTC"), goodcryptoX obecnie obsługuje model oparty na wyzwalaczach. Każdy webhook po prostu aktywuje predefiniowaną 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 za pośrednictwem webhooków, w tym dynamiczny wybór symbolu, ilości, typy zleceń i logikę wielosymbolową — działając w praktyce jako warstwa API. Bądź na bieżąco ### Bezpieczeństwo i dostęp * Na razie webhooki są akceptowane wyłącznie z serwerów TradingView — bez niestandardowych adresów IP ani zewnętrznych źródeł. * Jeśli musisz użyć niestandardowego źródła webhooków, skontaktuj się z nami pod adresem aby poprosić o dostęp. * Webhooki są dostępne tylko dla użytkowników z aktywnym planem PRO [plan](/goodcryptox-pl/ekosystem/plany-subskrypcji.md) lub wyższym. ### Jak działają webhooki w goodcryptoX * Każde zlecenie lub bot **akcja** ma własny dedykowany adres URL webhooka * Musisz najpierw utworzyć zlecenie lub bota, aby uzyskać URL (pojawią się one w **Webhooki** sekcji **Szczegóły**) * Wysyłanie **dowolnego** ładunku webhooka pod ten URL wywoła akcję > Adresy URL webhooków są specyficzne dla akcji, a nie dla użytkownika. Musisz utworzyć jeden webhook na akcję, np. jeden dla wejścia, jeden dla realizacji zysku, jeden dla stop lossa itp. 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 ma zastosowanie do: * Zlecenia stop-market / stop-limit wyzwalane * Aktywacja zleceń trailing (początek trailing) * Wyzwalacze take-profit i stop-loss * Warunek wejścia botów DCA
Po utworzeniu znajdziesz wszystkie dostępne adresy URL webhooków w **Szczegóły** 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 | | Wyzwól zlecenie Stop | ✅ | Należy wybrać webhook podczas konfiguracji | | Aktywuj zlecenie Trailing | ✅ | Początek trailing = webhook | | Wyzwól take profit / stop loss | ✅ | Opcjonalnie wyzwalane webhookiem | | Bot DCA - wejście | ✅ | Wejście kupna/sprzedaży przez webhook (musi być ustawione przy konfiguracji) | | Bot DCA - wyjście | ✅ | Zamknij pozycję przez webhook (zawsze dostępne) | | Bot Grid - wejście | 🚫 | Jeszcze nieobsługiwane | {% hint style="info" %} **Wiele celów take-profit z webhookami** Jeśli skonfigurujesz grupę take-profit używając webhooka jako metody wyzwalania, wszystkie będą korzystać z tego samego adresu URL webhooka. Za każdym razem, gdy webhook zostanie wywołany, zostanie wykonane następne zlecenie TP w sekwencji — po kolei. {% endhint %} ### Jak ustawić alerty w TradingView Gdy utworzysz zlecenie lub bota w goodcryptoX i skopiujesz adres URL webhooka dla konkretnej akcji, oto jak powiązać go z alertami TradingView: 1. Przejdź do wykresu w TradingView 2. Utwórz nowy alert oparty na swojej strategii, wskaźniku lub warunku 3. W **ustawieniach alertu**, zaznacz pole wyboru **„Webhook URL”** 4. Wklej konkretny adres URL webhooka z sekcji Webhooks w goodcryptoX 5. Pozostaw **pole wiadomości** bez zmian (dowolna treść jest OK — goodcryptoX na razie ignoruje ładunek) 6. Zapisz alert ### Powtarzające się strategie (przez bota DCA) Zlecenie wyzwalane webhookiem (np. stop-market z TP i SL) to **jednorazowa konfiguracja**. Gdy zlecenie zostanie wykonane i powiązany TP lub SL zadziała, cały handel jest zakończony. Jeśli chcesz, aby ta struktura **powtarzała się automatycznie**, nie jest to możliwe przy użyciu zleceń — ale jest osiągalne teraz za pomocą bota DCA. Wkrótce wprowadzimy dedykowany [bot strategii TradingView](/goodcryptox-pl/handel-cex/nadchodzace-funkcje/bot-strategii-tradingview.md) aby wspierać powtarzające się transakcje wieloetapowe, ale tymczasem bot DCA zapewnia elastyczny sposób powtarzania strategii opartej na webhookach. #### Czysta pętla webhooków Aby ustawić bota, który wchodzi w pozycję na webhook, wychodzi na webhook, a następnie się 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 **„Powtórz przy zamknięciu pozycji”**
Po uruchomieniu bota zobaczysz następujące adresy URL webhooków w **Szczegóły → Webhooks** sekcji: * **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, gdy jest bezczynny. * Gdy pozycja jest otwarta: * Wszelkie dalsze sygnały wejścia są **ignorowane** * Bot nie zwiększy ani nie odwróci bieżącej pozycji na sygnały Wejścia * Jedynymi akceptowanymi sygnałami są **zamknij pozycję** lub wyzwolony TP/SL (jeśli skonfigurowano) * 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 Ci powtarzać pełny cykl wejście → wyjście → reset w nieskończoność. #### Czysty tryb webhooków vs hybrydowe konfiguracje 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ć oparte na cenie TP/SL jako zabezpieczenia awaryjne, nawet jeśli używasz wyjść webhook * Dodać zlecenia uśredniające dla dodatkowej ochrony To umożliwia zaprojektowanie: * Całkowicie zautomatyzowanych strategii pętlowych (czysty webhook) * Botów sterowanych sygnałami z ręcznymi przełączeniami awaryjnymi * Hybrydowych konfiguracji z wielowarstwowymi wyjściami ### Praktyczne przykłady strategii z webhookami #### Przykład 1: Zlecenie jednorazowe + wiele poziomów 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 **Wyzwalacz** adresu URL webhooka 2. Cena wraca do wnętrza wstęgi → wyślij do **Wyzwalacz Take Profit** adresu URL webhooka 3. Cena przecina środkową wstęgę → wyślij do **Wyzwalacz Take Profit** adresu URL webhooka 4. Cena przebija górną wstęgę → wyślij do **Wyzwalacz Take Profit** adresu URL webhooka
W **ustawieniach alertu**, zaznacz pole wyboru **„Webhook URL”** Wklej konkretny adres URL webhooka z sekcji Webhooks 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ź na long przy Golden Cross, wejdź na short przy Death Cross. Wyjdź przy 10% zysku lub gdy 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: „Powtórz przy TP” **Konfiguracja w TradingView** * Utwórz trzy alerty na tym samym wykresie: 1. SMA50 przecina SMA200 w górę → wyślij do **Wejdź Kupno** webhook 2. SMA50 przecina SMA200 w dół → wyślij do **Wejdź Sprzedaż** webhook 3. RSI > 70 → wyślij do **Zamknij pozycję** webhook {% hint style="info" %} Bot DCA utrzymuje tylko jedną pozycję na raz. Gdy jest w pozycji, ignoruje nowe webhooki wejścia, dopóki pozycja nie zostanie zamknięta. Jeśli chcesz móc wchodzić w pozycje Long i Short na tym samym instrumencie równolegle - utwórz dwa oddzielne boty i wysyłaj Wejdź Kupno do jednego, a Wejdź Sprzedaż do drugiego {% endhint %} ### Podsumowanie | Koncepcja | Opis | | -------------------------- | -------------------------------------------------------------------------- | | Model wyzwalania | Każda akcja ma własny adres URL webhooka | | Przepływ konfiguracji | Utwórz zlecenie → skopiuj adres URL webhooka → wklej do alertu TradingView | | Powtarzająca się strategia | Użyj bota DCA z włączonym powtarzaniem | | Dostęp | Wymaga planu PRO lub wyższego | ### Samouczki wideo #### **Wprowadzenie do handlu za pomocą webhooków** {% embed url="" %} #### **Używanie bota DCA z webhookami** {% embed url="" %} #### **Wiele take-profitów z webhookami** {% 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/handel-cex/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.