# 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="/files/cd832269097c9d30002ae1b85a41dc35634de9e7" 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="/files/56351507d11f30a3c572ef0a04b64fa693a6d261" 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="/files/17d66e8a129b7738a069341c12352959387ee335" 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="/files/21f5ca34b1edf3cf9d88809bca94871542070042" 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="/files/fd94866e9812cb30bd75ceb9d2b7295e2e9b02ce" 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                         |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.goodcrypto.app/goodcryptox-de/dex-handel-spot/webhooks.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
