# 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](/goodcryptox-de/perp-dexs/funktionalitat-in-kurze/tradingview-strategie-bot.md) 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](/goodcryptox-de/okosystem/abonnementplane.md) 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="/files/d1b528226550701d981bee3f9d7dfef072c89b20" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="/files/b574fc83e0cc46e3494de0bbdecab7e899b47239" 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="/files/80056ba052687823a99338274c73ad092d8bac8a" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="/files/1915409aa765375f938b5d0122b5f54e70e14ae7" 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](/goodcryptox-de/cex-handel/funktionalitat-in-kurze/tradingview-strategie-bot.md) 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="/files/ebc1b2b7067d0041b3257f64df79c4fbd2c3f43e" 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="/files/9bb8df0512ba2f2fe05ec2c356a9026ff170c63a" 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="/files/dce5bedae458000faf808c12a9697ed81b2f9787" 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>" %}


---

# 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/cex-handel/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.
