# Webhooks

goodcryptoX ermöglicht Ihnen die Automatisierung von DEX-Handel über TradingView-Webhooks — ein leistungsfähiger Mechanismus, um Aufträge und Bot-Aktionen direkt von Ihren Signalen auszulösen.

Im Gegensatz zu einigen Implementierungen, die Webhooks wie eine programmierbare API behandeln (bei der Sie parametrisierte Befehle wie „kaufe 3 BTC“ senden), unterstützt goodcryptoX derzeit ein triggerbasiertes Modell. Jeder Webhook aktiviert einfach eine vordefinierte Aktion an einer bestimmten Order oder einem bestimmten Bot — es werden keine Parameter oder Befehle interpretiert.

In naher Zukunft werden wir einen neuen TradingView-Strategy-Bot starten, der vollständige Strategieanweisungen über Webhooks unterstützt, einschließlich dynamischer Symbolauswahl, Mengen, Orderarten und Multi-Symbol-Logik — und damit effektiv als API-Schicht fungiert. Bleiben Sie dran

> Webhooks werden vorerst nur von TradingView-Servern akzeptiert — keine benutzerdefinierten IPs oder externen Quellen.\
> Wenn Sie eine benutzerdefinierte Webhook-Quelle verwenden müssen, kontaktieren Sie uns unter <support@goodcrypto.app> um Zugang zu beantragen.

### Wie Webhooks in goodcryptoX funktionieren

* Jede Order oder jeder Bot **Aktion** hat seine eigene dedizierte Webhook-URL
* Sie müssen die Order oder den Bot zuerst erstellen, um die URL zu erhalten (sie erscheinen im **Webhooks** Abschnitt der **Details**)
* Senden **irgendeines** Webhook-Payloads an diese URL wird die Aktion auslösen

Hier ist eine Videoübersicht:

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

> Webhook-URLs sind actionspezifisch. Sie müssen einen Webhook pro Aktion erstellen, z. B. einen für Entry, einen für Take Profit, einen für Stop Loss usw. für jeden Bot oder jede Order

### Unterstützte Order- und Bot-Aktionen

Wenn Sie möchten, dass Ihre Order oder Ihr Bot **durch einen Webhook ausgelöst wird**, müssen Sie während der Einrichtung Webhook als **Auslösebedingung auswählen**. Dies gilt für:

* Limit-Orders auslösen
* Trailing-Order-Aktivierung (Trailing-Start)
* Take-Profit- und Stop-Loss-Auslöser&#x20;
* DCA-Bot Entry-Bedingung

> **Abbrechen** Webhook — immer verfügbar in allen Orders und Bots
>
> **Position schließen** Webhook — immer verfügbar in den DCA-Bot-Details

<figure><img src="https://255243788-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>

Nach der Erstellung finden Sie alle verfügbaren Webhook-URLs im **Details** Ihres Orders oder Bots:

<figure><img src="https://255243788-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>

Zusammengefasst:

| Aktion                           | Unterstützt? | Hinweise                                                                 |
| -------------------------------- | ------------ | ------------------------------------------------------------------------ |
| Order abbrechen                  | ✅            | Immer in den Details angezeigt                                           |
| Limit-Order auslösen             | ✅            | Webhook muss bei der Einrichtung ausgewählt werden                       |
| Trailing-Order aktivieren        | ✅            | Trailing-Start = Webhook                                                 |
| Take Profit / Stop Loss auslösen | ✅            | Optional per Webhook auslösbar                                           |
| DCA-Bot - Entry                  | ✅            | Entry-Kauf/Verkauf per Webhook (muss bei der Einrichtung gesetzt werden) |
| DCA-Bot - Exit                   | ✅            | Position per Webhook schließen (immer verfügbar)                         |

{% hint style="info" %}
**Mehrere Take-Profit-Ziele mit Webhooks**

Wenn Sie eine Take-Profit-Gruppe einrichten und Webhook als Auslösemethode wählen, teilen sie sich alle dieselbe Webhook-URL. Jedes Mal, wenn der Webhook ausgelöst wird, wird die nächste TP-Order in der Reihenfolge ausgeführt — nacheinander.
{% endhint %}

### So richten Sie Alerts in TradingView ein

Sobald Sie Ihre Order oder Ihren Bot in goodcryptoX erstellt und die Webhook-URL für eine bestimmte Aktion kopiert haben, verbinden Sie diese wie folgt mit Ihren TradingView-Alerts:

1. Gehen Sie zu Ihrem Chart in TradingView
2. Erstellen Sie einen neuen Alert basierend auf Ihrer Strategie, Ihrem Indikator oder Ihrer Bedingung
3. In den **Alert-Einstellungen**, aktivieren Sie das Kontrollkästchen **„Webhook-URL“**
4. Fügen Sie die spezifische Webhook-URL aus dem goodcryptoX **Verfügbare Webhooks** Abschnitt ein
5. Lassen Sie das **Nachrichtenfeld** unverändert (jeglicher Inhalt ist in Ordnung — goodcryptoX ignoriert das Payload vorerst)
6. Speichern Sie den Alert

### Wiederholende Strategien (via DCA-Bot)

Eine per Webhook ausgelöste Order (z. B. Limit mit TP und SL) ist eine **einmalige Einrichtung**. Sobald die Order ausgeführt ist und der verknüpfte TP oder SL ausgelöst wurde, ist der gesamte Trade abgeschlossen. Wenn Sie möchten, dass diese Struktur sich **automatisch wiederholt**, ist das bei Orders nicht möglich — aber es ist jetzt mit dem DCA-Bot realisierbar.

Wir werden bald einen dedizierten TradingView-Strategy-Bot einführen, um wiederholende Multi-Action-Trades zu unterstützen, aber in der Zwischenzeit bietet der DCA-Bot eine flexible Möglichkeit, Ihre webhookgesteuerte Strategie zu wiederholen.

#### Reine Webhook-Schleife

Um einen Bot einzurichten, der per Webhook eine Position eröffnet, per Webhook schließt und dann wiederholt:

1. Setzen Sie **Entry-Bedingung** = Webhook
2. Setzen Sie **Averaging-Orders** = 0 (Averaging deaktivieren)
3. Deaktivieren Sie sowohl **Take**-**Profit** und **Stop-Loss**
4. Aktivieren Sie **„Beim Schließen der Position wiederholen“**

<figure><img src="https://255243788-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>

Sobald der Bot gestartet ist, sehen Sie die folgenden Webhook-URLs unter den **Details → Webhooks** des Bots:

* **Enter Buy** — öffnet eine Long-Position
* **Position schließen** — schließt die aktive Position (long oder short)
* **Abbrechen** — stoppt den Bot

**Ausführungslogik**

* Wenn der Bot **Enter Buy**erhält, öffnet er eine Long-Position.
* Der Bot wird **nur auf den ersten Entry-Webhook reagieren** , den er empfängt, während er inaktiv ist.
* Während eine Position offen ist:
  * Jegliche weiteren Entry-Signale werden **ignoriert**
  * Die einzigen akzeptierten Signale sind **Position schließen** oder ein ausgelöster TP/SL (falls konfiguriert)
* Sobald die Position geschlossen ist (manuell, per Webhook oder durch SL/TP), setzt sich der Bot zurück und wartet auf den nächsten Entry-Webhook.

Diese Schleife setzt sich fort, solange der Bot aktiv bleibt, sodass Sie einen vollständigen Entry → Exit → Reset-Zyklus unbegrenzt wiederholen können.

#### Reiner Webhook-Modus vs. hybride Setups

Der DCA-Bot unterstützt mehrere Steuerungsebenen, die kombiniert werden können, um flexible Strategien zu erstellen:

* **Entry**: via Webhook, Signal oder sofort
* **Exit**: via Webhook oder integriertes preisgestütztes TP/SL
* **Averaging**: optional; kann deaktiviert werden

Sie können:

* Einen Bot vollständig über Webhook-Signale betreiben (Entry und Exit)
* Preisbasierte TP/SL als Fallbacks hinzufügen, auch wenn Sie Webhook-Exits verwenden
* Averaging-Orders für zusätzlichen Schutz hinzufügen

Das macht es möglich, zu entwerfen:

* Vollautomatisierte Schleifenstrategien (reiner Webhook)
* Signalgesteuerte Bots mit manuellen Ausweichoptionen
* Hybride Setups mit mehrschichtigen Exits

### Praktische Webhook-Strategie-Beispiele

#### Beispiel 1: Einmalige Order + mehrere Take Profits (Bollinger-Band-Abpraller)

**Ziel:** Kaufen, wenn der Preis das untere Bollinger-Band durchbricht, und progressiv verkaufen, während er steigt.

**Einrichtung in goodcryptoX**

* Erstellen Sie eine Limit-Order mit Auslösebedingung = Webhook
* Fügen Sie drei Take-Profit-Ziele hinzu. TP-Auslöser = Webhook

<figure><img src="https://255243788-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>

**Einrichtung in TradingView**

Erstellen Sie vier Alerts:

1. Preis durchbricht unteres Band → senden an die **Trigger** Webhook-URL der Hauptorder
2. Preis kehrt ins Band zurück → senden an **Take-Profit-Auslöser** Webhook-URL der Hauptorder
3. Preis kreuzt Mittelband → senden an **Take-Profit-Auslöser** Webhook-URL der Hauptorder
4. Preis durchbricht oberes Band → senden an **Take-Profit-Auslöser** Webhook-URL der Hauptorder

<figure><img src="https://255243788-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>

In den **Alert-Einstellungen**, aktivieren Sie das Kontrollkästchen **„Webhook-URL“**

Fügen Sie die spezifische Webhook-URL aus dem goodcryptoX **Verfügbare Webhooks** Abschnitt. Lassen Sie das Nachrichtenfeld unverändert — es wird nicht verwendet.

#### Beispiel 2: Wiederholende Strategie mit DCA-Bot (Golden/Death Cross)

**Ziel:** Long beim Golden Cross eingehen, Short beim Death Cross eingehen. Mit 10 % Gewinn aussteigen oder wenn RSI > 70, und für immer wiederholen.

**Einrichtung in goodcryptoX**

Erstellen Sie einen DCA-Bot

* Entry-Bedingung = Webhook
* Averaging = aus (auf 0 setzen)
* Take Profit = 10%
* Stop Loss = aus
* Aktivieren: „Beim TP wiederholen“

**Einrichtung in TradingView**

* Erstellen Sie drei Alerts im selben Chart:
  1. SMA50 kreuzt über SMA200 → senden an **Enter Buy** Webhook
  2. SMA50 kreuzt unter SMA200 → senden an **Enter Sell** Webhook
  3. RSI > 70 → senden an **Position schließen** Webhook

### Zusammenfassung

| Konzept                 | Beschreibung                                                           |
| ----------------------- | ---------------------------------------------------------------------- |
| Auslöser-Modell         | Jede Aktion hat ihre eigene Webhook-URL                                |
| Einrichtungsablauf      | Order erstellen → Webhook-URL kopieren → in TradingView-Alert einfügen |
| Wiederholende Strategie | DCA-Bot mit aktivierter Wiederholung verwenden                         |