Spezifikationen für die Alarmmeldungen des Handelssignal Bots 2.0
Inhaltsverzeichnis
Einführung
Mit dem Launch von Signal Bots können TradingView Benutzerinnen und Benutzer jetzt Ihre Signale veröffentlichen und einen Signal Bot auf OKX erstellen. In diesem Leitfaden gehen wir die verschiedenen Spezifikationen für die Alarmmeldungen durch, die OKX für Benutzerinnen und Benutzer unterstützt.
Für diejenigen, die sich mit PineScript™ gut auskennen und sich ausschließlich auf Strategie-Skripte verlassen, um Signale zu senden, haben wir ein exklusives Spezifikationsformat entwickelt. Dieses Format integriert nahtlos die Platzhalter der PineScript™ Strategie und ermöglicht es Ihnen, Handelssignale mit einer bemerkenswerten Leichtigkeit zu übertragen. Wenn Sie ein nativer PineScript™-Strategie-Benutzer oder eine -Benutzerin sind, ist dieses Format Ihr idealer Begleiter. Es bietet Ihnen eine moderne Methode, um Ihre Strategie-Skripte mit den Strategie-Platzhaltern von TradingView zusammenzuführen. Wenn Sie Strategien schreiben und die strategy.*()-Funktonen nutzen, um Ihr Handelssignal zu erstellen, gehen Sie bitte zum Abschnitt A - für PineScript Strategie-Benutzerinnen und -Benutzer.
Wir verstehen jedoch, dass sich nicht jede oder jeder ausschließlich auf PineScript-Strategie-Skripts verlässt. In Abschnitt B - Allgemein einsetzbar dieses Leitfadens bieten wir eine Reihe vielseitiger Spezifikationen, die über Skripting-Methoden hinaus gehen. Diese Spezifikationen funktionieren für alle Methoden der Signalerstellung. Egal, ob Sie benutzerdefinierte Indikatoren, verschiedene Charting-Techniken, oder sogar manuelle Alarme verwenden - dieses „One size fits all“-Rahmenwerk für Spezifikationen hilft Ihnen weiter.
Ein Überblick zu Pine Script™: „Strategie“ vs. „Indikator“
Pine Script™-Strategien dienen sowohl dem Backtesting auf historischen Daten als auch dem Forward-Testing in Live-Märkten. Neben der Durchführung von Indikatorberechnungen enthalten Strategie Aufrufe von strategy.*()-Funktionen, die Handelsorders an den Broker-Emulator von Pine Script™ übermitteln. Dieser Emulator kann dann die Ausführung dieser Orders simulieren. Das Ergebnis der Backtests wird im Reiter „Strategie-Tester“ am unteren Ende des Charts neben dem Reiter „Pine Script™ Editor“ angezeigt.
Pine Script™ Indikatoren beinhalten zwar auch Berechnungen, sind aber nicht für die Nutzung von Backtesting-Szenarien gedacht. Durch die Unabhängigkeit vom Broker-Emulator benötigen Indikatoren weniger Ressourcen und führen schneller aus.
Es ist wichtig zu erwähnen, dass Sie sowohl das Format in Abschnitt A als auch das Format in Abschnitt B verwenden können - beide sind vollständig kompatibel. Anhan der von Ihnen übermittelten Nachrichten erkennt das System auf intelligente Weise das verwendete Format und analysiert Ihre Nachrichten entsprechend. Diese intelligente Verarbeitung sorgt unabhängig von Ihrer gewählten Methode für ein einwandfreies Erlebnis.
Abschnitt A (PineScript™ Strategie-Benutzerinnen und Benutzer)
Die folgenden Spezifikationen sind speziell auf Benutzerinnen und Benutzer zugeschnitten, die Ihre Algorithmen mithilfe von PineScript™ Strategien und der Funktion strategy.*() erstellen. Dieses Format ist für die Anpassung von Strategieplatzhaltern vorgesehen und gewährleistet eine nahtlose Anpassbarkeit. Weitere Informationen für ein tieferes Verständnis von Strategie-Skripts und des Prozesses der Sendung von Alarmen unter Verwendung von Strategieplatzhaltervariablen finden Sie unter diesem Link.
Wenn das Konzept neu für Sie ist, liefert Ihnen Abschnitt B eine alternative Methode für die Erstellung von Alarmen, die auf ein breiteres Spektrum von Szenarien anwendbar ist.
Überblick über die Spezifikationen für Alarmmeldungen
Parameter
|
Erforderlich
|
Werte
|
id
|
Erforderlich
|
|
action
|
Erforderlich
|
|
marketPosition
|
Erforderlich
|
|
prevMarketPosition
|
Erforderlich
|
|
instrument
|
Erforderlich
|
|
signalToken
|
Erforderlich
|
Von OKX bei der Signalerstellung bereitgestellt
|
timestamp
|
Erforderlich
|
{{timenow}} von TradingView
|
maxLag
|
Optional
|
Nicht-negativer ganzzahliger Wert zwischen [1, 3600]. Standardmäßig bei 60.
|
investmentType
|
Optional*
|
|
amount
|
Erforderlich
|
|
1. AlertMsg Spezifikation - id
id - Die Order-Kennzeichnung
{{strategy.order.id}} - gibt die ID der ausgeführten Order zurück (der String, der als erster Parameter in einem der Funktionsaufrufe verwendet wird, die Orders erzeugen: strategy.entry, strategy.exit oder strategy.order).
2. AlertMsg Spezifikation - action
action - Kaufen oder Verkaufen?
{{strategy.order.action}} - gibt den String „kaufen“ oder „verkaufen“ für die ausgeführte Order zurück.
3. AlertMsg Spezifikation - marketPosition
marketPosition - Beabsichtigter Positionsstatus (bei Orderausführung)
{{strategy.market_position}} - gibt die aktuelle Position der Strategie im Stringformat zurück: „long“, „flat“, oder „short“.
4. AlertMsg Spezifikation - prevMarketPosition
prevMarketPosition - Vorheriger Positionsstatus (vor der Orderausführung)
{{strategy.prev_market_position}} - gibt die vorherige Position der Strategie im Stringformat zurück: „long“, „flat“, oder „short“.
5. AlertMsg Spezifikation - instrument
Format 1: ticker - TradingView Platzhalterwerte
Ein 'Standard Platzhalter'* ist ein wörtlicher Text, der von doppelten geschweiften Klammern umgeben ist und in einer Alarmmeldung enthalten ist.
"{{ticker}}" Setzt den Ticker des Instruments zurück, bei dem der Alarm ausgelöst wurde.
Beispiel: "BTCUSDT.P", "ETHUSDT.P".
*Standard Platzhalter für den Zugriff auf Variablen in PineScript™. Erfahren Sie mehr hier.
Format 2: OKX Instrument Format
Instrument ID, oder „instId“ in OKX API. Weitere Informationen finden Sie über diesen Link.
Beispiel: "BTC-USDT-SWAP", "ETH-USDT-SWAP"
6. AlertMsg Spezifikation - signalToken
signalToken -- Authentifizierung für das Signal
Der Token ist eine Sicherheitsmaßnahme, um sicherzustellen, dass die eingehende Anfrage seriös und autorisiert ist. Dieser signalToken wird automatisch generiert, wenn eine Benutzerin oder ein Benutzer erfolgreich ein neues Signal auf unserer Plattform erstellt hat und muss in die TradingView Alarmnachricht kopiert werden.
So finden Sie den signalToken für ein bereits aktives Signal
- Überprüfen Sie die Abschnitt Details Ihres Signals
- Suchen Sie Ihren signalToken im Abschnitt empfohlene Alarmmeldungen
7. AlertMsg Spezifikation - timestamp
timenow - TradingView Platzhalterwerte
Ein 'Standard Platzhalter'* ist ein wörtlicher Text, der von doppelten geschweiften Klammern umgeben ist und in einer Alarmmeldung enthalten ist.
"{{timenow}}" Gibt die aktuelle und genaue Uhrzeit an, zu der der Alarm ausgelöst wurde, in UTC und im Format jjjj-mm-ttThh:mm:ssZ.
Beispiel: "2023-06-01T17:38:10Z"
*Standard Platzhalter für den Zugriff auf Variablen in PineScript. Erfahren Sie mehr hier.
8. AlertMsg Spezifikation - maxLag
maxLag - Maximal annehmbare Verzögerung
Der Begriff „maxLag“ bezieht sich auf die maximal zulässige Verzögerung oder Latenzzeit, gemessen in Sekunden, bevor ein Handelssignal als ungültig betrachtet wird. Die Berechnung des maxLag beinhaltet die Bestimmung des Zeitunterschiedes zwischen dem Zeitpunkt, zu dem das Signal von TradingView gesendet wurde (unter Verwendung des Feldes „timestamp“ in der Alarmnachricht) und dem Zeitpunkt, zu dem es auf OKX empfangen wurde, um eine Order auszuführen.
Standardmäßig ist dieser Wert auf 60 Sekunden eingestellt. Das Festlegen eines maxLag-Wertes stellt sicher, dass der Signal-Bot zeitnah arbeitet und nicht auf veraltete oder möglicherweise ungenaue Signale reagiert, die eventuell nicht mehr die aktuellen Marktbedingungen widerspiegeln.
9. AlertMsg Spezifikation - investmentType & amount
Wichtiger Hinweis: Um eine optimale Kompatibilität mit Ihrer TradingView Strategie sicherzustellen, empfehlen wir Ihnen dringend den investmentType als „base“ und den Betrag als „{{strategy.order.contracts}}„ festzulegen. Auf diese Weise, stimmt die Order-Menge auf OKX mit der festgelegten Order-Menge Ihrer TradingView Strategie überein.
investmentType und Amount
(NUR FÜR EINSTIEGSSIGNALE)
- base: Betrag in der Basiswährung (Empfohlene Wahl)
- margin: Investierte Margin in der Notierungswährung
- contract: Eine feste Anzahl an Kontrakten
- percentage_balance: Basierend auf dem % des verfügbaren Saldos (z.B. Die verfügbare Margin zur Eröffnung neuer Orders)
- percentage_investment: Basierend auf dem Prozentsatz des aktiven Investments in Ihrem Bot. Das aktive Investment entspricht in der Regel Ihrer anfänglich investierten Marge zum Zeitpunkt der Bot-Erstellung und bleibt fest, bis Sie mehr Marge nachlegen und sich entscheiden, diesen Wert zu erhöhen. Zum Beispiel: Wenn Sie einen Bot mit einer anfänglich investierten Marge von 1000 USDT erstellen, wird Ihr aktives Investment auf 1000 USDT festgelegt. Für eingehende Signale ist dies der Wert, der für die Berechnung Ihrer Auftragsgröße verwendet wird. Angenommen, nach einigen Tagen des Betriebs Ihres Bots entscheiden Sie, dass er gut funktioniert, und investieren weitere 1000 USDT Marge und fügen sie Ihrem aktiven Investment hinzu. Danach wird Ihr aktives Investment auf 2000 USDT erhöht, und dies ist der neue Wert, der für die Berechnung Ihrer Auftragsgröße verwendet wird. Wenn Sie unsicher sind, welchen Wert Ihr Bot derzeit für das aktive Investment hat, können Sie dies jederzeit unter dem Abschnitt "Bot-Details" überprüfen.
(NUR FÜR AUSSTIEGSSIGNALE)
- base: Betrag in der Basiswährung (Empfohlene Wahl)
- percentage_position: Basierend auf dem % der offenen Position
Abschnitt B (Allgemein einsetzbar)
Die unten aufgeführten Spezifikationen sind vielseitig und können an jedes Szenario angepasst werden. Egal, ob Sie PineScript™ für die Erstellung von Strategie- oder Indikator (Study)-Skripts nutzen, oder manuell Alarme in Ihrer TradingView Alarm-Benutzeroberfläche einstellen - diese Spezifikationen bleiben anpassbar und individualisierbar.
Überblick über die Spezifikationen für Alarmmeldungen
Parameter | Erforderlich | Werte |
---|---|---|
action | Erforderlich |
|
instrument | Erforderlich |
|
signalToken | Erforderlich | Von OKX bei der Signalerstellung bereitgestellt |
timestamp | Erforderlich | {{timenow}} von TradingView |
maxLag | Optional | Nicht-negativer ganzzahliger Wert zwischen [1, 3600]. Standardmäßig bei 60. |
orderType | Optional. Parameter wird benötigt, wenn die Order-Art = Limit ist |
|
orderPriceOffset | Optional. Der Parameter wird benötigt, wenn bei der Erstellung des OKX Signal-Bots keine Einstellungen vorgenommen wurden | Gleitender Wert zwischen [0, 100] in % |
investmentType | Optional. Parameter wird benötigt, wenn die Order-Art = Limit ist |
|
amount | Optional. Parameter wird benötigt, wenn die Order-Art = Limit ist |
|
1. AlertMsg Spezifikation - action
Positionsmodus:
Der Signal-Bot arbeitet nur im One-Way-Modus (z.B. Kauf/Verkauf). Das bedeutet, dass der Bot nur Positionen in einer Richtung für ein bestimmtes Instrument hält.
Orders eröffnen
- ENTER_LONG: Eröffnen Sie eine Long-Position in der Erwartung, dass der Kurs steigen wird.
- ENTER_SHORT: Eröffnen Sie eine Short-Position in der Erwartung, dass der Kurs sinken wird.
Orders schließen
- EXIT_LONG: Schließen Sie eine Long-Position teilweise oder vollständig, indem Sie die Haltepositionen verkaufen.
- EXIT_SHORT: Schließen Sie eine Short-Position teilweise oder vollständig, indem Sie die Kontrakte zurückkaufen.
2. AlertMsg Spezifikation - instrument
Format 1: ticker - TradingView Platzhalterwerte
Ein 'Standard Platzhalter'* ist ein wörtlicher Text, der von doppelten geschweiften Klammern umgeben ist und in einer Alarmmeldung enthalten ist.
"{{ticker}}" Setzt den Ticker des Instruments zurück, bei dem der Alarm ausgelöst wurde.
Beispiel: "BTCUSDT.P", "ETHUSDT.P".
*Standard Platzhalter für den Zugriff auf Variablen in PineScript™. Erfahren Sie mehr hier.
Format 2: OKX Instrument Format
Instrument ID, oder „instId“ in OKX API. Weitere Informationen finden Sie über diesen Link.
Beispiel: "BTC-USDT-SWAP", "ETH-USDT-SWAP"
3. AlertMsg Spezifikation - signalToken
signalToken - Authentifizierung für das Signal
Der Token ist eine Sicherheitsmaßnahme, um sicherzustellen, dass die eingehende Anfrage seriös und autorisiert ist. Dieser signalToken wird automatisch generiert, wenn eine Benutzerin oder ein Benutzer erfolgreich ein neues Signal auf unserer Plattform erstellt hat und muss in die TradingView Alarmnachricht kopiert werden.
4. AlertMsg Spezifikation - timestamp
timenow - TradingView Platzhalterwerte
Ein 'Standard Platzhalter'* ist ein wörtlicher Text, der von doppelten geschweiften Klammern umgeben ist und in einer Alarmmeldung enthalten ist.
"{{timenow}}" Gibt die aktuelle und genaue Uhrzeit an, zu der der Alarm ausgelöst wurde, in UTC und im Format jjjj-mm-ttThh:mm:ssZ.
Mögliche Formatierung (UTC Zeit, ISO 8061 Format)
- jjjj-MM-ttTHH:mm:ssZ Format Zum Beispiel: "2023-06-01T17:38:10Z"
- jjjj-MM-ttTHH:mm:ss.SSSZ Format Zum Beispiel: "2023-06-01T17:38:10.836Z"
- jjjj-MM-ttTHH:mm:ss+0000 Format Zum Beispiel: "2023-06-01T17:38:10+0000"
Beispiel: "2023-06-01T17:38:10Z"
*Standard Platzhalter für den Zugriff auf Variablen in PineScript. Erfahren Sie mehr hier.
5. AlertMsg Spezifikation - maxLag
maxLag - Maximal annehmbare Verzögerung
Der Begriff „maxLag“ bezieht sich auf die maximal zulässige Verzögerung oder Latenzzeit, gemessen in Sekunden, bevor ein Handelssignal als ungültig betrachtet wird. Die Berechnung des maxLag beinhaltet die Bestimmung des Zeitunterschiedes zwischen dem Zeitpunkt, zu dem das Signal von TradingView gesendet wurde (unter Verwendung des Feldes „timestamp“ in der Alarmnachricht) und dem Zeitpunkt, zu dem es auf OKX empfangen wurde, um eine Order auszuführen.
Standardmäßig ist dieser Wert auf 60 Sekunden eingestellt. Das Festlegen eines maxLag-Wertes stellt sicher, dass der Signal Bot zeitnah arbeitet und nicht auf veraltete oder möglicherweise ungenaue Signale reagiert, die eventuell nicht mehr die aktuellen Marktbedingungen widerspiegeln.
6. AlertMsg Spezifikation- order
orderType
- Market: Platzieren Sie eine Market-Order um eine Position zu öffnen (wenn action =ENTER_XX) oder zu schließen (wenn action =EXIT_XX). orderPriceOffset müssen Sie nicht festlegen
- Limit: Platzieren Sie eine Limit-Order um eine Position zu öffnen (wenn action =ENTER_XX) oder zu schließen (wenn action =EXIT_XX).
orderPriceOffset (Trifft NUR bei LIMIT-Orders zu)
- ENTER_LONG: [1-(orderPriceOffset/100)] * Bid-1
- ENTER_SHORT: [1+(orderPriceOffset/100)] * Ask-1
- EXIT_LONG: [1+(orderPriceOffset/100)] * Ask-1
- EXIT_SHORT: [1-(orderPriceOffset/100)] * Bid-1
7. AlertMsg Spezifikation - investmentType & amount
investmentType und Amount
(NUR FÜR EINSTIEGSSIGNALE)
- Margin: Investierte Margin in der Notierungswährung
- Contract: Eine feste Anzahl an Kontrakten
- Percentage_balance: Basierend auf dem % des verfügbaren Saldos (z.B. Die verfügbare Margin zur Eröffnung neuer Orders)
- Percentage_investment: Basierend auf dem Prozentsatz des aktiven Investments in Ihrem Bot. Das aktive Investment entspricht in der Regel Ihrer anfänglich investierten Marge zum Zeitpunkt der Bot-Erstellung und bleibt fest, bis Sie mehr Marge nachlegen und sich entscheiden, diesen Wert zu erhöhen. Zum Beispiel: Wenn Sie einen Bot mit einer anfänglich investierten Marge von 1000 USDT erstellen, wird Ihr aktives Investment auf 1000 USDT festgelegt. Für eingehende Signale ist dies der Wert, der für die Berechnung Ihrer Auftragsgröße verwendet wird. Angenommen, nach einigen Tagen des Betriebs Ihres Bots entscheiden Sie, dass er gut funktioniert, und investieren weitere 1000 USDT Marge und fügen sie Ihrem aktiven Investment hinzu. Danach wird Ihr aktives Investment auf 2000 USDT erhöht, und dies ist der neue Wert, der für die Berechnung Ihrer Auftragsgröße verwendet wird. Wenn Sie unsicher sind, welchen Wert Ihr Bot derzeit für das aktive Investment hat, können Sie dies jederzeit unter dem Abschnitt "Bot-Details" überprüfen.
(NUR FÜR AUSSTIEGSSIGNALE)
- Percentage_position: Basierend auf dem % der offenen Positionen
Abschnitt B Praxisbeispiele
Beispiel 1: Long-Einstieg - Long-Ausstieg (Vollständig) ohne Multi-Entry
Beispiel 2: Long-Einstieg - > Short-Einstieg (Einstufige Umkehrung) ohne Multi-Entry
Beispiel 3: Long-Einstieg - Long-Ausstieg (Teilweise) - Long-Ausstieg (Vollständig)
Beispiel 4: Verwendung von Multi-Entry
Multi-Entry ist eine Funktion beim Signal Bot, die die Ausführung mehrerer Einstiegspunkte für ein bestimmtes Instrument ermöglicht. Händlerinnen und Händler können ihr Handelskonzept anpassen, indem sie die Einstiegspunkte verifizieren (z.B. Durchschnittskosteneffekt) und so die Chancen auf profitable Geschäfte in einem dynamischen Marktumfeld erhöhen.
Beispiel 5: Nur Verwendung des Triggersignals (ohne Order-bezogene Felder)
Bei Signalanbietern können sie bestimmte optionale Parameter ausschließen, wenn die Benutzerin oder der Benutzer sie bereits im Bot konfiguriert hat. Das ist vor allem für Anbieter nützlich, die sich AUSSCHLIEßLICH auf das Angebot von Kauf-/Verkauf-Trigger-Signalen fokussieren und bei denen jede Teilnehmerin oder jeder Teilnehmer selbst entscheiden kann, wie viel sie oder er investieren möchte.
Beispiel 6: Nur Verwendung des Triggersignals (ohne Order-bezogene Felder)
Wenn sowohl beim Signal als auch die Bot-Konfiguration keine Orderdetails angeben, werden die Standardwerte verwendet.
- Bei ENTER Signalen werden standardmäßig X%* Investitionen mit einer Market-Order eröffnet.
- Bei EXIT Signalen werden standardmäßig 100% der offenen Positionen bei Erhalt des Signals geschlossen.
*** X = 100 beim Einzelpaar. X = 50 beim Multi-Paar
Beispiel 7: Feld-Order Vorrang
Bot-Parameter haben Vorrang vor Signal-Parametern. Es gibt zwei Regeln, die Sie beachten müssen:
- Regel 1: Sowohl der Bot als auch das Signal definieren das Feld
Für Order-Art
|
Market Order (Bot) ✅
|
Limit Order (Signal) ❌
|
- Regel 2: Entweder Bot oder Signal definiert das Feld
Für Investment Type und Amount
|
N/A (Bot) ❌
|
100 % Verfügbarer Saldo (Signal) ✅
|
Häufig gestellte Fragen
Wenn Sie Fragen zum Signal-Bot haben, können Sie einige der am häufigsten gestellten Fragen unserer Benutzerinnen und Benutzer in diesem Artikel nachlesen.