# Webhooks

goodcryptoX ermöglicht es Ihnen, Handelsaktionen über TradingView-Webhooks zu automatisieren — ein leistungsstarker Mechanismus zum Auslösen von Orders und Bot-Aktionen direkt aus Ihren Signalen.

Im Unterschied 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 für eine bestimmte Order oder einen 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/bevorstehende-funktionen/tradingview-strategie-bot) starten, der vollständige Strategiebefehle über Webhooks unterstützt, einschließlich dynamischer Symbolauswahl, Mengen, Ordertypen und Multi-Symbol-Logik — und damit effektiv als API-Schicht fungiert. Bleiben Sie dran

### Sicherheit und Zugriff

* 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.
* Webhooks sind nur für Nutzer mit einem aktiven PRO [Plan](https://docs.goodcrypto.app/goodcryptox-de/okosystem/abonnementplane) oder höher verfügbar.

### 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**)
* Das Senden **irgendeines** Webhook-Payloads an diese URL löst die Aktion aus

> Webhook-URLs sind aktion-spezifisch, nicht benutzer-spezifisch. 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 **Triggerbedingung auswählen**. Dies gilt für:

* Stop-Market / Stop-Limit Orders Auslösen
* Aktivierung von Trailing-Orders (Trailing-Start)
* Take-Profit- und Stop-Loss-Auslöser&#x20;
* Entry-Bedingung von DCA-Bots

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

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%2FKTTUr7eaKAlb7x0U818J%2Fimage.png?alt=media&#x26;token=6b2a978f-fd3c-48b0-b01a-40da32d44696" alt="" width="563"><figcaption></figcaption></figure>

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

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

Zusammengefasst:

| Aktion                           | Unterstützt? | Anmerkungen                                                              |
| -------------------------------- | ------------ | ------------------------------------------------------------------------ |
| Order abbrechen                  | ✅            | Immer in den Details angezeigt                                           |
| Stop-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 via Webhook (muss bei der Einrichtung gesetzt werden) |
| DCA-Bot - Exit                   | ✅            | Position per Webhook schließen (immer verfügbar)                         |
| Grid-Bot - Entry                 | 🚫           | Noch nicht unterstützt                                                   |

{% 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 alle dieselbe Webhook-URL. Jedes Mal, wenn der Webhook ausgelöst wird, wird die nächste TP-Order in der Reihenfolge ausgeführt — eine nach der anderen.
{% endhint %}

### So richten Sie Alerts in TradingView ein

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

1. Öffnen Sie Ihr 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 Webhooks-Bereich von goodcryptoX ein
5. Lassen Sie das **Nachrichtenfeld** unverändert (jeder Inhalt ist in Ordnung — goodcryptoX ignoriert die Payload vorerst)
6. Speichern Sie den Alert

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

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

Wir werden bald einen dedizierten [TradingView-Strategie-Bot](https://docs.goodcrypto.app/goodcryptox-de/cex-trading/bevorstehende-funktionen/tradingview-strategie-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.

#### Reiner Webhook-Loop

Um einen Bot einzurichten, der per Webhook in eine Position einsteigt, per Webhook aussteigt und dann wiederholt:

1. Stellen Sie die **Entry-Bedingung** = Webhook
2. Stellen Sie die **Averaging-Orders** = 0 (Averaging deaktivieren)
3. Deaktivieren Sie sowohl **Take**-**Profit** als auch **Stop-Loss**
4. Aktivieren Sie **„Bei Positionsschließung wiederholen“**&#x20;

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

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

* **Enter Buy** — eröffnet eine Long-Position
* **Enter Sell** — eröffnet eine Short-Position
* **Position schließen** — schließt die aktive Position (Long oder Short)
* **Abbruch** — stoppt den Bot

**Ausführungslogik**

* Wenn der Bot **Enter Buy**erhält, öffnet er eine Long-Position.
* Wenn er **Enter Sell**erhält, öffnet er eine Short-Position.
* Der Bot wird **nur auf den ersten Entry-Webhook reagieren,** den er im Leerlaufzustand erhält.
* Während eine Position offen ist:
  * Weitere Entry-Signale werden **ignoriert**
  * Der Bot wird die aktuelle Position bei Entry-Signalen nicht vergrößern oder umkehren
  * 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.

Dieser Loop 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 asap
* **Exit**: via Webhook oder eingebaute preisbasierte 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, selbst wenn Sie Webhook-Exits verwenden
* Averaging-Orders für zusätzlichen Schutz hinzufügen

Damit ist es möglich, zu entwerfen:

* Vollautomatisierte Loop-Strategien (reiner Webhook)
* Signalgesteuerte Bots mit manuellen Fallbacks
* Hybride Setups mit mehrschichtigen Exits

### Praktische Webhook-Strategie-Beispiele

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

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

**Einrichtung in goodcryptoX**

* Erstellen Sie eine Stop-Market-Order mit Triggerbedingung = Webhook
* Fügen Sie drei Take-Profit-Ziele hinzu. TP-Trigger = Webhook

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

**Einrichtung in TradingView**

Erstellen Sie vier Alerts:

1. Preis durchbricht das untere Band → an die Hauptorder senden **Trigger** Webhook-URL
2. Preis kehrt ins Band zurück → an **Take-Profit-Trigger** Webhook-URL
3. Preis kreuzt das Mittelband → an **Take-Profit-Trigger** Webhook-URL
4. Preis durchbricht das obere Band → an **Take-Profit-Trigger** Webhook-URL

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

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

Fügen Sie die spezifische Webhook-URL aus dem Webhooks-Bereich von goodcryptoX ein. Lassen Sie das Nachrichtenfeld unverändert — es wird nicht verwendet.

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

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

**Einrichtung in goodcryptoX**

DCA-Bot erstellen

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

**Einrichtung in TradingView**

* Erstellen Sie drei Alerts auf demselben 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

{% hint style="info" %}
Der DCA-Bot hält jeweils nur eine Position. Während einer offenen Position ignoriert er neue Entry-Webhooks, bis die Position geschlossen ist.

Wenn Sie in der Lage sein möchten, Long- und Short-Positionen auf demselben Instrument parallel einzugehen – erstellen Sie zwei separate Bots und senden Sie Enter Buy an den einen und Enter Sell an den anderen
{% endhint %}

### Zusammenfassung

| Konzept                 | Beschreibung                                                           |
| ----------------------- | ---------------------------------------------------------------------- |
| Trigger-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                         |
| Zugriff                 | Erfordert PRO-Plan oder höher                                          |

### Video-Tutorials

#### **Einführung in Webhook-Trading**

{% embed url="<https://youtu.be/JDkJFOwjjzk?si=m0GBGwTt6GTau-9X>" %}

#### **Verwendung des DCA-Bots mit Webhooks**

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

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

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