# Webhooks

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](https://docs.goodcrypto.app/goodcryptox-pl/perp-dexy/nadchodzace-funkcje/bot-strategii-tradingview) 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 <support@goodcrypto.app> 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&#x20;
* Warunek wejścia bota DCA

<figure><img src="https://495821443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FOtmSJHlKDJLkbCquvUfC%2Fimage.png?alt=media&#x26;token=c152200c-d5ad-4d69-861d-7c66700cd569" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="https://495821443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2F278uiG55cCWY8A3XpJxm%2Fimage.png?alt=media&#x26;token=7d852fc3-0ef4-45ab-921d-eab0d2287e97" alt="" width="563"><figcaption></figcaption></figure>

Po utworzeniu znajdziesz wszystkie dostępne URL-e webhooków w **Szczegóły** szczegółach twojego zlecenia lub bota:

<figure><img src="https://495821443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FKTTUr7eaKAlb7x0U818J%2Fimage.png?alt=media&#x26;token=6b2a978f-fd3c-48b0-b01a-40da32d44696" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="https://495821443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FNoneMggO61H3EFmkwTrP%2Fimage.png?alt=media&#x26;token=f6f48a58-1585-41e3-8778-b69fe9564902" alt="" width="563"><figcaption></figcaption></figure>

> **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](https://docs.goodcrypto.app/goodcryptox-pl/perp-dexy/nadchodzace-funkcje/bot-strategii-tradingview) 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"**&#x20;

<figure><img src="https://495821443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FCquwy7JurEJkuO9rQeWn%2Fimage.png?alt=media&#x26;token=542f9526-7ecb-4033-8b1c-740aef270b51" alt="" width="375"><figcaption></figcaption></figure>

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

<figure><img src="https://495821443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FU5f3sdUx8rAIkSpfuLd0%2Fimage.png?alt=media&#x26;token=2772d1dd-038b-435b-bcd6-1aad6f95575d" alt="" width="563"><figcaption></figcaption></figure>

**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

<figure><img src="https://495821443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FW35WIYkwAwONvOjjPukZ%2Fimage.png?alt=media&#x26;token=8562ad00-e7fe-4d26-8a34-38eff5c05207" alt="" width="563"><figcaption></figcaption></figure>

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="<https://youtu.be/JDkJFOwjjzk?si=m0GBGwTt6GTau-9X>" %}

#### **Używanie bota DCA z webhookami**

{% embed url="<https://youtu.be/gHXB2S6qdXU?si=i9ZobjRsxFAe7zcJ>" %}

#### **Wiele take-profits przez webhooki**

{% embed url="<https://youtu.be/xF-O7ZDoDtU?si=apfiF8uyTn-p4Vh4>" %}