> For the complete documentation index, see [llms.txt](https://docs.goodcrypto.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.goodcrypto.app/goodcryptox-de/dex-trading-spot/webhooks.md).

# Webhooks

goodcryptoX ermöglicht es Ihnen, den DEX-Handel über TradingView-Webhooks zu automatisieren — ein leistungsstarker Mechanismus, um Orders und Bot-Aktionen direkt aus Ihren Signalen auszulösen.

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

In naher Zukunft werden wir einen neuen TradingView-Strategie-Bot veröffentlichen, der vollständige Strategieanweisungen über Webhooks unterstützt, einschließlich dynamischer Symbolauswahl, Mengen, Ordertypen und Multisymbol-Logik — und damit effektiv als API-Schicht fungiert. Bleiben Sie dran

> Webhooks werden derzeit 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 Zugriff anzufordern.

### Wie Webhooks in goodcryptoX funktionieren

* Jede Order oder jeder Bot **Aktion** hat eine eigene dedizierte Webhook-URL
* Du musst zuerst die Order oder den Bot erstellen, um die URL zu erhalten (sie erscheinen in der **Webhooks** Sektion der Order oder des Bots **Details**)
* Senden **einer beliebigen** Webhook-Payload an diese URL löst die Aktion aus

Hier ist ein Video-Überblick:

> Webhook-URLs sind aktionenspezifisch. Sie müssen für jede Aktion einen eigenen Webhook erstellen, z. B. einen für den Einstieg, 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 du möchtest, dass deine Order oder dein Bot **durch einen Webhook ausgelöst wird**, musst du Webhook als die **Auslösebedingung bei der Einrichtung auswählen**. Dies gilt für:

* Limit-Orders lösen aus
* Aktivierung der Trailing-Order (Trailing-Start)
* Take-Profit- und Stop-Loss-Auslösungen
* Einstiegsbedingung des DCA-Bots

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

<figure><img src="https://255243788-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdN30dLOECKAJpKz7dTr8%2Fuploads%2Fgit-blob-e4fe6d10ec72c31c3a97b73468449bf13541eb0d%2Fimage.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

Nach der Erstellung findest du alle verfügbaren Webhook-URLs in der **Details** deiner Order oder deines Bots:

<figure><img src="https://255243788-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdN30dLOECKAJpKz7dTr8%2Fuploads%2Fgit-blob-e4fe6d10ec72c31c3a97b73468449bf13541eb0d%2Fimage.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

Zusammenfassend:

| Aktion                           | Unterstützt? | Hinweise                                                                           |
| -------------------------------- | ------------ | ---------------------------------------------------------------------------------- |
| Order abbrechen                  | ✅            | Wird in den Details immer angezeigt                                                |
| Limit-Order auslösen             | ✅            | Bei der Einrichtung muss Webhook ausgewählt werden                                 |
| Trailing-Order aktivieren        | ✅            | Trailing-Start = Webhook                                                           |
| Take Profit / Stop Loss auslösen | ✅            | Optional per Webhook auslösbar                                                     |
| DCA-Bot - Einstieg               | ✅            | Einstieg Kaufen/Verkaufen per Webhook (muss bei der Einrichtung festgelegt werden) |
| DCA-Bot - Ausstieg               | ✅            | Position per Webhook schließen (immer verfügbar)                                   |

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

Wenn du eine Take-Profit-Gruppe mit Webhook als Auslösemechanismus einrichtest, teilen 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 richtest du Alarme in TradingView ein

Nachdem du deine Order oder deinen Bot in goodcryptoX erstellt und die Webhook-URL für eine bestimmte Aktion kopiert hast, erfährst du hier, wie du sie mit deinen TradingView-Alarmen verknüpfst:

1. Gehe in TradingView zu deinem Chart
2. Erstelle einen neuen Alarm basierend auf deiner Strategie, deinem Indikator oder deiner Bedingung
3. In den **Alarmeinstellungen**, aktiviere das Kontrollkästchen **„Webhook-URL“**
4. Fügen Sie die spezifische Webhook-URL aus goodcryptoX ein **Verfügbare Webhooks** Abschnitt
5. Lasse das **Nachrichtenfeld** unverändert (jeder Inhalt ist in Ordnung — goodcryptoX ignoriert die Payload vorerst)
6. Speichere den Alarm

### Wiederholende Strategien (über DCA-Bot)

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

Wir werden bald einen dedizierten TradingView-Strategie-Bot einführen, um wiederholte Multi-Aktions-Trades zu unterstützen, aber bis dahin bietet der DCA-Bot eine flexible Möglichkeit, Ihre webhook-gesteuerte Strategie zu wiederholen.

#### Reine Webhook-Schleife

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

1. Setze **Einstiegsbedingung** = Webhook
2. Setze **Averaging-Orders** = 0 (Averaging deaktivieren)
3. Deaktiviere beide **Take**-**Profit** und **Stop-Loss**
4. Aktiviere **"Beim Schließen der Position wiederholen"**

<figure><img src="https://255243788-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdN30dLOECKAJpKz7dTr8%2Fuploads%2Fgit-blob-e4fe6d10ec72c31c3a97b73468449bf13541eb0d%2Fimage.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

Sobald der Bot gestartet ist, siehst du die folgenden Webhook-URLs unter den **Details → Webhooks** Abschnitt:

* **Kauf eingeben** — eröffnet eine Long-Position
* **Position schließen** — schließt die aktive Position (Long oder Short)
* **Abbrechen** — stoppt den Bot

**Ausführungslogik**

* Wenn der Bot **Kauf eingeben**erhält, eröffnet er eine Long-Position.
* Der Bot wird **nur auf den ersten Einstiegs-Webhook reagieren** , den er im Leerlauf erhält.
* Während eine Position offen ist:
  * Weitere Einstiegssignale werden **ignoriert**
  * Die einzigen akzeptierten Signale sind **Position schließen** oder ein ausgelöstes 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 Einstiegs-Webhook.

Diese Schleife läuft weiter, solange der Bot aktiv bleibt, sodass du einen vollständigen Einstieg → Ausstieg → Zurücksetzen-Zyklus unbegrenzt wiederholen kannst.

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

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

* **Einstieg**: per Webhook, Signal oder sofort
* **Ausstieg**: per Webhook oder integriertem preisbasiertem TP/SL
* **Averaging**: optional; kann deaktiviert werden

Du kannst:

* Einen Bot vollständig über Webhook-Signale ausführen (Ein- und Ausstieg)
* Preisbasiertes TP/SL als Fallback hinzufügen, auch wenn du Webhook-Ausstiege verwendest
* Averaging-Orders für zusätzlichen Schutz hinzufügen

Dadurch ist es möglich, Folgendes zu gestalten:

* Vollautomatisierte Schleifenstrategien (reiner Webhook)
* Signalgesteuerte Bots mit manuellen Fallbacks
* Hybride Setups mit mehrstufigen Ausstiegen

### Praktische Webhook-Strategiebeispiele

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

**Ziel:** Kaufe, wenn der Preis das untere Bollinger-Band durchbricht, und verkaufe schrittweise, während er steigt.

**Einrichtung in goodcryptoX**

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

<figure><img src="https://255243788-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdN30dLOECKAJpKz7dTr8%2Fuploads%2Fgit-blob-e4fe6d10ec72c31c3a97b73468449bf13541eb0d%2Fimage.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

**Einrichtung in TradingView**

Erstelle vier Alarme:

1. Preis durchbricht das untere Band → sende an den **Auslöser** Webhook-URL
2. Preis kehrt in das Band zurück → sende an **Take-Profit-Auslöser** Webhook-URL
3. Preis kreuzt das mittlere Band → sende an **Take-Profit-Auslöser** Webhook-URL
4. Preis durchbricht das obere Band → sende an **Take-Profit-Auslöser** Webhook-URL

<figure><img src="https://255243788-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdN30dLOECKAJpKz7dTr8%2Fuploads%2Fgit-blob-e4fe6d10ec72c31c3a97b73468449bf13541eb0d%2Fimage.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

In den **Alarmeinstellungen**, aktiviere das Kontrollkästchen **„Webhook-URL“**

Fügen Sie die spezifische Webhook-URL aus goodcryptoX ein **Verfügbare Webhooks** Abschnitt. Lassen Sie das Feld „Message“ unverändert — es wird nicht verwendet.

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

**Ziel:** Gehe bei Golden Cross long, bei Death Cross short. Steige mit 10 % Gewinn aus oder wenn RSI > 70 ist, und wiederhole es endlos.

**Einrichtung in goodcryptoX**

DCA-Bot erstellen

* Einstiegsbedingung = Webhook
* Averaging = aus (auf 0 setzen)
* Take Profit = 10 %
* Stop-Loss = aus
* Aktivieren: "Bei TP wiederholen"

**Einrichtung in TradingView**

* Erstelle drei Alarme im selben Chart:
  1. SMA50 kreuzt über SMA200 → sende an **Kauf eingeben** Webhook
  2. SMA50 kreuzt unter SMA200 → sende an **Verkauf eingeben** Webhook
  3. RSI > 70 → sende an **Position schließen** Webhook

### Zusammenfassung

| Konzept                 | Beschreibung                                                               |
| ----------------------- | -------------------------------------------------------------------------- |
| Trigger-Modell          | Jede Aktion hat ihre eigene Webhook-URL                                    |
| Einrichtungsablauf      | Order erstellen → Webhook-URL kopieren → in den TradingView-Alarm einfügen |
| Wiederholende Strategie | Verwende den DCA-Bot mit aktivierter Wiederholung                          |
