# Webhooks

goodcryptoX ermöglicht es Ihnen, Handelsaktionen über TradingView-Webhooks zu automatisieren — 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 (wo Sie parametrisierte Befehle wie „kaufe 3 BTC“ senden), unterstützt goodcryptoX derzeit ein triggerbasiertes Modell. Jeder Webhook aktiviert einfach eine vordefinierte Aktion für einen bestimmten Auftrag oder 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) einführen, der vollständige Strategieanweisungen über Webhooks unterstützt, einschließlich dynamischer Symbolauswahl, Mengen, Ordertypen 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 Zugriff anzufordern.

### Wie Webhooks in goodcryptoX funktionieren

* Jeder Auftrag oder Bot **Aktion** hat seine eigene dedizierte Webhook-URL
* Sie müssen den Auftrag oder Bot zuerst erstellen, um die URL zu erhalten (sie werden im **Webhooks** Abschnitt der **Details**)
* Jeder **beliebige** Webhook-Payload an diese URL löst die Aktion aus

> Webhook-URLs sind actionspezifisch, nicht benutzerspezifisch. 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 Auftrag

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

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

* Stop-Market / Stop-Limit-Aufträge auslösen
* Aktivierung von Trailing-Aufträgen (Trailing-Start)
* Take-Profit- und Stop-Loss-Auslöser&#x20;
* DCA-Bot Einstiegskriterium

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

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

Zusammengefasst:

| Aktion                           | Unterstützt? | Anmerkungen                                                                  |
| -------------------------------- | ------------ | ---------------------------------------------------------------------------- |
| Auftrag stornieren               | ✅            | Immer in den Details angezeigt                                               |
| Stop-Auftrag auslösen            | ✅            | Webhook muss bei der Einrichtung ausgewählt werden                           |
| Trailing-Auftrag aktivieren      | ✅            | Trailing-Start = Webhook                                                     |
| Take Profit / Stop Loss auslösen | ✅            | Optional per Webhook ausgelöst                                               |
| DCA-Bot - Einstieg               | ✅            | Einstiegs-Kauf/Verkauf via Webhook (muss bei der Einrichtung gesetzt werden) |
| DCA-Bot - Ausstieg               | ✅            | Position über Webhook schließen (immer verfügbar)                            |
| Grid-Bot - Einstieg              | 🚫           | Noch nicht unterstützt                                                       |

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

Wenn Sie eine Take-Profit-Gruppe einrichten und als Auslösemethode Webhook 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 — nacheinander.
{% endhint %}

### So richten Sie Alarme in TradingView ein

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

1. Gehen Sie in TradingView zu Ihrem Chart
2. Erstellen Sie einen neuen Alarm basierend auf Ihrer Strategie, Ihrem Indikator oder Ihrer Bedingung
3. In den **Alarm-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** wie es ist (jeder Inhalt ist in Ordnung — goodcryptoX ignoriert die Payload vorerst)
6. Speichern Sie den Alarm

### Wiederholende Strategien (via DCA-Bot)

Ein per Webhook ausgelöster Auftrag (z. B. Stop-Market mit TP und SL) ist eine **einmalige Einrichtung**. Sobald der Auftrag ausgeführt wird und der verknüpfte TP oder SL auslöst, ist der gesamte Trade abgeschlossen. Wenn Sie möchten, dass diese Struktur **sich automatisch wiederholt**, ist das mit Aufträgen nicht möglich — aber es ist jetzt mit dem DCA-Bot erreichbar.

Wir werden bald einen dedizierten [TradingView-Strategie-Bot](https://docs.goodcrypto.app/goodcryptox-de/perp-dexs/bevorstehende-funktionen/tradingview-strategie-bot) einführen, um sich 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 eine Position eröffnet, per Webhook schließt und dann wiederholt:

1. Setzen Sie **Einstiegsbedingung** = Webhook
2. Setzen Sie **Averaging-Aufträge** = 0 (Averaging deaktivieren)
3. Deaktivieren Sie sowohl **Take**-**Profit** und **Stop-Loss**
4. Aktivieren Sie **„Beim Schließen der Position 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** des Bots:

* **Enter Buy** — öffnet eine Long-Position
* **Enter Sell** — öffnet eine Short-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.
* Wenn er **Enter Sell**erhält, öffnet er eine Short-Position.
* Der Bot wird **nur auf den ersten Entry-Webhook** reagieren, den er im Leerlauf erhält.
* Während eine Position offen ist:
  * Alle weiteren 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 kompletten 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 bauen:

* **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, auch wenn Sie Webhook-Exits verwenden
* Averaging-Aufträge für zusätzlichen Schutz hinzufügen

Damit ist es möglich, zu entwerfen:

* Vollautomatische Loop-Strategien (reiner Webhook)
* Signalgetriebene Bots mit manuellen Failovers
* Hybride Setups mit mehrschichtigen Exits

### Praktische Beispiele für Webhook-Strategien

#### Beispiel 1: Einmalauftrag + 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 einen Stop-Market-Auftrag 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%2FU5f3sdUx8rAIkSpfuLd0%2Fimage.png?alt=media&#x26;token=2772d1dd-038b-435b-bcd6-1aad6f95575d" alt="" width="563"><figcaption></figcaption></figure>

**Einrichtung in TradingView**

Erstellen Sie vier Alarme:

1. Preis durchbricht unteres Band → senden an die Hauptauftrag- **Trigger** Webhook-URL
2. Preis kehrt ins Band zurück → senden an **Take-Profit-Auslöser** Webhook-URL
3. Preis kreuzt Mittelband → senden an **Take-Profit-Auslöser** Webhook-URL
4. Preis durchbricht oberes Band → senden 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%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FW35WIYkwAwONvOjjPukZ%2Fimage.png?alt=media&#x26;token=8562ad00-e7fe-4d26-8a34-38eff5c05207" alt="" width="563"><figcaption></figcaption></figure>

In den **Alarm-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 wie es ist — es wird nicht verwendet.

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

**Ziel:** Einstieg long beim Golden Cross, Einstieg short beim Death Cross. Ausstieg mit 10% Gewinn oder wenn RSI > 70 und für immer wiederholen.

**Einrichtung in goodcryptoX**

Erstellen Sie einen DCA-Bot

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

**Einrichtung in TradingView**

* Erstellen Sie drei Alarme 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

{% 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      | Auftrag erstellen → Webhook-URL kopieren → in TradingView-Alarm einfügen |
| Wiederholende Strategie | DCA-Bot mit aktivierter Wiederholung verwenden                           |

### 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>" %}