Wonach suchst du?

1. Zweck und Überblick #

Die Webhook-Funktion ermöglicht es, Trades in der OptionsApp durch externe Signale zu eröffnen oder zu schließen. Dabei wird kein Einstieg oder Ausstieg über klassische Filter- oder Triggerlogik innerhalb der App ausgelöst, sondern über einen von außen gesendeten Webhook.

Die Funktion kann sowohl in Entry Conditions als auch in Exit Conditions verwendet werden:

• In einer Entry Condition dient der Webhook dazu, einen Trade zu eröffnen.
• In einer Exit Condition dient der Webhook dazu, einen laufenden Trade zu schließen.

Ein typischer Anwendungsfall ist die Anbindung externer Automatisierungs- oder Signaldienste, beispielsweise TradingView. Die Funktion ist jedoch nicht auf einen bestimmten Anbieter beschränkt.

2. Funktionsweise #

Jede Webhook-Condition ist eindeutig einer aktiven Session in der OptionsApp sowie einer konkreten Entry- oder Exit-Condition zugeordnet.

Nach dem Erstellen eines Webhooks stellt die OptionsApp folgende Informationen bereit:

• eine Webhook-URL
• einen vorbereiteten Payload mit den verschlüsselten Zuordnungswerten
  • session_key
  • webhook_condition_id

Wird dieser Webhook von einem externen System an die angegebene URL gesendet, kann die OptionsApp das Signal eindeutig der richtigen Session und der richtigen Condition zuordnen.

Dadurch ist sichergestellt, dass das Signal nur dort verarbeitet wird, wo es auch tatsächlich hingehört.

3. Einsatzbereich #

Die Webhook-Funktion kann in zwei Bereichen genutzt werden.

3.1 Entry Condition #

Wird ein Webhook in einer Entry Condition verwendet, kann dadurch ein Trade eröffnet werden.

Voraussetzung ist, dass:

• die Webhook-Condition korrekt erstellt wurde
• die Condition einem Trade innerhalb einer Strategie zugeordnet wurde
• die betreffende Session aktiv ist

Sobald das externe Signal gesendet wird, verarbeitet die OptionsApp den Webhook und startet die zugehörige Trade-Eröffnung.

3.2 Exit Condition #

Wird ein Webhook in einer Exit Condition verwendet, kann dadurch ein bestehender Trade geschlossen werden.

Auch hier gilt:

• die Exit Condition muss als Webhook angelegt sein
• sie muss dem entsprechenden Trade bzw. der Strategie zugeordnet sein
• die Session muss aktiv sein

Sobald das externe Signal eintrifft, wird die zugehörige Exit-Logik ausgeführt.

4. Einrichtung eines Webhooks #

Die Einrichtung erfolgt im Bereich Configuration innerhalb der Entry Conditions oder Exit Conditions.

4.1 Navigation #

Ein Webhook kann wie folgt angelegt werden:

• In den Bereich Configuration wechseln
• Entry Conditions oder Exit Conditions öffnen
• Eine neue Condition hinzufügen
• Rechts oben bei der Auswahl des Condition-Typs statt Filter oder Trigger den Punkt Webhook auswählen

Nach Auswahl von Webhook verändert sich die Eingabemaske entsprechend.

4.2 Webhook-Condition anlegen #

Nach Auswahl von Webhook sollte zunächst ein Name für die Condition vergeben werden.

Anschließend stehen folgende Elemente zur Verfügung:

• das Feld WEBHOOK URL
• der Button Copy URL
• der Button Create Webhook
• ein Bereich zur Vorschau des Payloads

Solange noch kein Webhook erstellt wurde, ist noch kein vollständiger Payload vorhanden.

4.3 Webhook erstellen #

Mit Klick auf Create Webhook wird der Webhook erzeugt.

Danach zeigt die OptionsApp:

• die verwendete Webhook-URL
• den vorbereiteten Payload mit den zugehörigen verschlüsselten Werten

Der angezeigte Payload enthält die Informationen, die von dem externen System beim Webhook-Versand verwendet werden müssen.

Die Zuordnung erfolgt dabei über:

• session_key zur Identifikation der laufenden Session
• webhook_condition_id zur Identifikation der konkreten Webhook-Condition

4.4 Einrichtung abschließen #

Nach dem Erstellen des Webhooks muss die Condition mit Confirm gespeichert werden.

Erst danach ist die Webhook-Condition vollständig in der OptionsApp angelegt.

Zusätzlich ist erforderlich, dass die Entry- oder Exit-Condition anschließend einem Trade innerhalb einer Strategie zugeordnet wird. Erst durch diese Zuordnung kann der Webhook später tatsächlich eine Trade-Eröffnung oder Trade-Schließung auslösen.

5. Test des Webhooks #

Nach dem Erstellen eines Webhooks steht zusätzlich die Funktion Test Webhook zur Verfügung.

Mit dieser Funktion kann geprüft werden, ob der Webhook grundsätzlich erfolgreich verarbeitet werden kann.

Wird der Test erfolgreich ausgeführt, erscheint eine entsprechende Meldung, dass der Webhook-Test erfolgreich war.

Der Test dient dazu, die technische Erreichbarkeit und Zuordnung des Webhooks zu überprüfen, bevor der Webhook produktiv durch ein externes System verwendet wird.

6. Anwendung des Webhook mit TradingView #

Ein typischer Anwendungsfall für den Webhook ist die Nutzung mit TradingView. Dort kann ein Alarm so eingerichtet werden, dass beim Auslösen automatisch ein Webhook an die OptionsApp gesendet wird.

Für die Nutzung ist ein TradingView-Account erforderlich, der Alarme und Webhook-Benachrichtigungen unterstützt.

6.1 Alarm in TradingView einrichten #

In der Chart-Ansicht von TradingView kann rechts über das Wecker-Symbol ein neuer Alarm erstellt werden.

Dort wird die gewünschte Alarmbedingung definiert, also z. B. wann ein Signal ausgelöst werden soll.

6.2 Webhook-URL eintragen #

Im Bereich Benachrichtigungen des Alarms muss die Option für Webhook aktiviert werden.

In das Feld Webhook-URL wird die URL eingetragen, die in der OptionsApp bei der entsprechenden Webhook-Condition angezeigt wird.

6.3 Nachricht einfügen #

Im Feld Nachricht des TradingView-Alarms muss der Inhalt aus dem Bereich Webhook Payload der OptionsApp eingefügt werden.

Dieser Inhalt muss unverändert übernommen werden.

6.4 Auslösung in der OptionsApp #

Sobald der Alarm in TradingView ausgelöst wird, sendet TradingView den Webhook an die OptionsApp.

Die OptionsApp ordnet das Signal automatisch der richtigen Session und der richtigen Webhook-Condition zu. Dadurch wird dann der zugewiesene Trade eröffnet oder geschlossen – je nachdem, ob der Webhook in einer Entry Condition oder Exit Condition verwendet wird.

7. Voraussetzungen für die Ausführung #

Damit ein Webhook in der Praxis verarbeitet werden kann, müssen mehrere Voraussetzungen erfüllt sein:

• die betreffende Session der OptionsApp ist aktiv
• der Webhook wurde in einer Entry Condition oder Exit Condition korrekt erstellt
• die Condition wurde gespeichert
• die Condition wurde einer Strategie bzw. einem Trade zugeordnet
• das externe System sendet den Webhook an die richtige URL mit den richtigen Parametern

Fehlt eine dieser Voraussetzungen, kann keine Ausführung erfolgen.

8. Hinweise zur Nutzung #

Die Webhook-Funktion dient ausschließlich als Auslöser für die Entry- oder Exit-Logik. Die eigentliche Trade-Ausführung erfolgt weiterhin im Rahmen der in der OptionsApp hinterlegten Strategie-, Template- und Orderlogik.

Das bedeutet insbesondere:

• der Webhook ersetzt kein Trade Template
• der Webhook ersetzt keine Strategiezuordnung
• der Webhook ersetzt keine bereits definierte Handelslogik
• der Webhook stellt lediglich das externe Signal für Start oder Schließung bereit

Für eine saubere Nutzung sollte daher immer geprüft werden, ob die betreffende Condition korrekt zugeordnet und die gesamte Strategie vollständig eingerichtet wurde.