> 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/perp-dexs/webhooks.md).

# Webhooks

goodcryptoX ermöglicht es dir, Handelsaktionen über TradingView-Webhooks zu automatisieren — ein leistungsstarker Mechanismus, um Orders und Bot-Aktionen direkt aus deinen 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](https://docs.goodcrypto.app/goodcryptox-de/perp-dexs/upcoming-functionality/tradingview-strategy-bot.md) veröffentlichen, der vollständige Strategieanweisungen per Webhook unterstützt, einschließlich dynamischer Symbolauswahl, Mengen, Ordertypen und Logik für mehrere Symbole — und damit effektiv als API-Schicht fungiert. Bleib 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

> Webhook-URLs sind aktionsspezifisch, nicht benutzerspezifisch. Du musst für jede Aktion einen 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:

* Auslösung von Stop-Market-/Stop-Limit-Orders
* Aktivierung von Trailing-Orders (Trailing-Start)
* Take-Profit- und Stop-Loss-Auslösungen
* Einstiegsbedingung von DCA-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="563"><figcaption></figcaption></figure>

<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="563"><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="563"><figcaption></figcaption></figure>

<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="563"><figcaption></figcaption></figure>

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

Zusammenfassend:

| Aktion                           | Unterstützt? | Hinweise                                                                           |
| -------------------------------- | ------------ | ---------------------------------------------------------------------------------- |
| Order abbrechen                  | ✅            | Wird in den Details immer angezeigt                                                |
| Stop-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)                                   |
| Grid-Bot - Einstieg              | 🚫           | Noch nicht unterstützt                                                             |

{% 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üge die spezifische Webhook-URL aus dem goodcryptoX-Webhooks-Bereich ein
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 Webhook ausgelöste Order (z. B. Stop-Market 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](https://docs.goodcrypto.app/goodcryptox-de/perp-dexs/upcoming-functionality/tradingview-strategy-bot.md) einführen, um wiederholende Multi-Aktions-Trades zu unterstützen; bis dahin bietet der DCA-Bot eine flexible Möglichkeit, deine 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
* **Verkauf eingeben** — eröffnet eine Short-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.
* Wenn er **Verkauf eingeben**erhält, eröffnet er eine Short-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**
  * Der Bot wird die aktuelle Position bei Einstiegssignalen weder erhöhen noch umkehren
  * 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**

* Erstelle eine Stop-Market-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="563"><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="563"><figcaption></figcaption></figure>

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

Füge die spezifische Webhook-URL aus dem goodcryptoX-Webhooks-Bereich ein. Lasse das Nachrichtenfeld 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

{% hint style="info" %}
Der DCA-Bot hält immer nur eine Position gleichzeitig. Während eine Position offen ist, ignoriert er neue Einstiegs-Webhooks, bis die Position geschlossen wird.

Wenn du Long- und Short-Positionen auf demselben Instrument parallel eröffnen können möchtest, erstelle zwei separate Bots und sende „Kauf eingeben“ an den einen und „Verkauf eingeben“ an den anderen
{% endhint %}

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

### Video-Tutorials

#### **Einführung in den Webhook-Handel**

#### **DCA-Bot mit Webhooks verwenden**

#### **Mehrere Take Profits mit Webhooks**
