# Webhooks

goodcryptoX umożliwia automatyzację handlu na DEX za pomocą webhooków TradingView — potężnego mechanizmu wywołującego zlecenia i akcje 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 zdefiniowaną wcześniej akcję dla konkretnego zlecenia lub bota — żadne parametry ani polecenia nie są interpretowane.

W niedalekiej przyszłości wprowadzimy nowego bota TradingView Strategy, który będzie obsługiwał pełne instrukcje strategii przez webhooki, włączając dynamiczny wybór symbolu, ilości, typy zleceń i logikę wielosymbolową — działając w praktyce jako warstwa API. Bądź na bieżąco

> Webhooki są obecnie akceptowane tylko z serwerów TradingView — żadnych niestandardowych adresów IP ani zewnętrznych źródeł.\
> Jeśli potrzebujesz używać niestandardowego źródła webhooków, skontaktuj się z nami pod <support@goodcrypto.app> aby poprosić o dostęp.

### Jak działają webhooki w goodcryptoX

* Każde zlecenie lub bot **akcja** ma swój własny dedykowany adres URL webhooka
* Musisz najpierw utworzyć zlecenie lub bota, aby otrzymać URL (pojawiają się one w **Webhooki** sekcji **Szczegóły**)
* Wysyłanie **dowolnego** ładunku webhooka pod ten URL wyzwoli akcję

Oto przegląd wideo:

{% embed url="<https://youtu.be/Mx-nD_p2Pgw>" %}

> Adresy URL webhooków są specyficzne dla akcji. 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ł **wyzwalany przez webhook**, musisz wybrać webhook jako **warunek wyzwalający podczas konfiguracji**. To dotyczy:

* Zlecenia limitowe wyzwalają
* Aktywacja zlecenia trailing (początek trailing)
* Wyzwalacze take-profit i stop-loss&#x20;
* Warunek wejścia bota DCA

> **Anuluj** webhook — zawsze dostępny we wszystkich zleceniach i botach
>
> **Zamknij pozycję** webhook — zawsze dostępny w szczegółach bota DCA

<figure><img src="https://495821443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2Fl2pfeXIwqa1tpvsFEldb%2Fimage.png?alt=media&#x26;token=99ca6c17-d547-47c7-abaf-1d1e3bb4e03a" alt="" width="375"><figcaption></figcaption></figure>

Po utworzeniu znajdziesz wszystkie dostępne adresy URL webhooków w **Szczegóły** Twojego zlecenia lub bota:

<figure><img src="https://495821443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FlG04MgjoXROWz32j0tN4%2Fimage.png?alt=media&#x26;token=08009fa1-7757-4495-b60e-1165e12887b3" alt="" width="375"><figcaption></figcaption></figure>

Podsumowując:

| Akcja                          | Obsługiwane? | Uwagi                                                                           |
| ------------------------------ | ------------ | ------------------------------------------------------------------------------- |
| Anuluj zlecenie                | ✅            | Zawsze widoczne w szczegółach                                                   |
| Wyzwól zlecenie limitowe       | ✅            | Należy wybrać webhook podczas konfiguracji                                      |
| Aktywuj zlecenie trailing      | ✅            | Początek trailing = webhook                                                     |
| Wyzwól 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              | ✅            | Zamknij pozycję przez webhook (zawsze dostępne)                                 |

{% hint style="info" %}
**Wiele celów take-profit za pomocą webhooków**

Jeśli skonfigurujesz grupę take-profit używając webhooka jako metody wyzwalania, będą one wszystkie dzielić ten sam adres URL webhooka. Za każdym razem, gdy webhook zostanie wywołany, zostanie wykonane następne zlecenie TP w sekwencji — jedno po drugim.
{% endhint %}

### Jak ustawić alerty w TradingView

Gdy utworzysz zlecenie lub bota w goodcryptoX i skopiujesz URL webhooka dla konkretnej akcji, oto jak połączyć go z alertami w 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 adres URL webhooka z goodcryptoX **Dostępne webhooki** sekcji
5. Pozostaw **pole wiadomości** bez zmian (dowolna treść jest ok — goodcryptoX obecnie ignoruje ładunek)
6. Zapisz alert

### Powtarzające się strategie (przez bota DCA)

Zlecenie wywołane webhookiem (np. limit z TP i SL) to **jednorazowa konfiguracja**. Gdy zlecenie się wykona i powiązany TP lub SL zostanie uruchomiony, cały handel zostaje zakończony. Jeśli chcesz, aby ta struktura **powtarzała się automatycznie**, to nie jest możliwe w przypadku zleceń — ale można to osiągnąć teraz używając bota DCA.

Wkrótce wprowadzimy dedykowanego bota strategii TradingView, który będzie wspierał powtarzające się wielo-akcyjne transakcje, ale tymczasem bot DCA daje elastyczny sposób na powtarzanie strategii sterowanej webhookami.

#### Czysta pętla webhooków

Aby skonfigurować 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 **„Powtarzaj po zamknięciu pozycji”**

<figure><img src="https://495821443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FNUBBrWgJqqqvjcnLBw7C%2Fimage.png?alt=media&#x26;token=ced6146d-5d8e-4496-94bc-0cb08cb57282" alt="" width="375"><figcaption></figcaption></figure>

Po uruchomieniu bota zobaczysz następujące adresy URL webhooków w **Szczegóły → Webhooki** sekcji:

* **Wejście Kup** — otwiera pozycję Long
* **Zamknij pozycję** — zamyka aktywną pozycję (long lub short)
* **Anuluj** — zatrzymuje bota

**Logika wykonania**

* Gdy bot otrzyma **Wejście Kup**, otwiera pozycję long.
* Bot będzie **odpowiadać tylko na pierwszy webhook wejścia** który otrzyma, będąc w stanie bezczynności.
* Gdy pozycja jest otwarta:
  * Wszelkie kolejne sygnały wejścia są **ignorowane**
  * Jedynymi akceptowanymi sygnałami są **zamknięcie pozycji** lub uruchomiony TP/SL (jeśli skonfigurowano)
* Gdy pozycja zostanie zamknięta (ręcznie, przez webhook lub przez SL/TP), bot resetuje się i czeka na następny webhook wejścia.

Ta pętla trwa tak długo, jak bot pozostaje aktywny, pozwalając powtarzać pełny 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 natychmiastowe
* **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 zabezpieczenia, 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ętli (czysty webhook)
* Botów sterowanych sygnałem z ręcznymi przejęciami awaryjnymi
* Konfiguracji hybrydowych z wielowarstwowym wyjściem

### Praktyczne przykłady strategii z webhookami

#### Przykład 1: Jednorazowe zlecenie + wiele take profit (odbicie od wstęg Bollingera)

**Cel:** Kupuj, gdy cena przebije dolną wstęgę Bollingera, sprzedawaj stopniowo w miarę wzrostu.

**Konfiguracja w goodcryptoX**

* Utwórz zlecenie limitowe z warunkiem wyzwalającym = webhook
* Dodaj trzy cele take-profit. Wyzwalacz TP = webhook

<figure><img src="https://495821443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2Ffg4E339WmltyEDaiNjma%2Fimage.png?alt=media&#x26;token=0ee7cab9-7575-4ac2-89c4-841693b2ba77" alt="" width="375"><figcaption></figcaption></figure>

**Konfiguracja w TradingView**

Utwórz cztery alerty:

1. Cena przebija dolną wstęgę → wyślij do głównego zlecenia **Wyzwalacz** adres URL webhooka
2. Cena wraca do wnętrza wstęgi → wyślij do **Wyzwalacz Take Profit** adres URL webhooka
3. Cena przecina środkową wstęgę → wyślij do **Wyzwalacz Take Profit** adres URL webhooka
4. Cena przebija górną wstęgę → wyślij do **Wyzwalacz Take Profit** adres URL webhooka

<figure><img src="https://495821443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2Fc3oNniHr6lmTUwc8qQ7V%2Fimage.png?alt=media&#x26;token=9787c6e6-5744-48cc-8ae1-a891fd775e8e" alt="" width="375"><figcaption></figcaption></figure>

W **ustawieniach alertu**, zaznacz pole wyboru **„Webhook URL”**

Wklej konkretny adres URL webhooka z goodcryptoX **Dostępne webhooki** sekcji. Pozostaw pole Wiadomość bez zmian — nie jest używane.

#### Przykład 2: Powtarzająca się strategia z botem DCA (Złoty/Śmierci Krzyż)

**Cel:** Wejdź w long przy Złotym Krzyżu, wejdź w short przy Krzyżu Śmierci. Wyjdź z 10% zyskiem 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: „Powtarzaj przy TP”

**Konfiguracja w TradingView**

* Utwórz trzy alerty na tym samym wykresie:
  1. SMA50 przecina powyżej SMA200 → wyślij do **Wejście Kup** webhook
  2. SMA50 przecina poniżej SMA200 → wyślij do **Wejście Sprzedaj** webhook
  3. RSI > 70 → wyślij do **Zamknij pozycję** webhook

### Podsumowanie

| Koncepcja                  | Opis                                                                 |
| -------------------------- | -------------------------------------------------------------------- |
| Model wyzwalania           | Każda akcja ma swój 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                               |