# Webhooks

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](https://docs.goodcrypto.app/goodcryptox-pl/perp-dexy/nadchodzace-funkcje/bot-strategii-tradingview) 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 <support@goodcrypto.app> aby poprosić o dostęp.
* Webhooki są dostępne tylko dla użytkowników z aktywnym planem PRO [plan](https://docs.goodcrypto.app/goodcryptox-pl/ekosystem/plany-subskrypcyjne) 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&#x20;
* Warunek wejścia botów 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 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%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                                                |
| 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](https://docs.goodcrypto.app/goodcryptox-pl/handl-na-cex/nadchodzace-funkcje/bot-strategii-tradingview) 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”**&#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 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

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

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

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

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

#### **Wiele take-profitów z webhookami**

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