Non tutti i prodotti menzionati sono disponibili in tutte le giurisdizioni.

Specifiche del messaggio di avviso di Trading Signal Bot 2.0

Data di pubblicazione: 30 ago 2023Data di aggiornamento: 3 lug 202418 minuti di lettura

Indice

Introduzione

Con il lancio dei Signal Bot, gli utenti di TradingView possono pubblicare i propri segnali e creare un Signal Bot su OKX. In questa guida ti illustreremo le varie specifiche relative ai messaggi di avviso supportate da OKX.

Per coloro che conoscono bene PineScript™ e si affidano esclusivamente agli script di strategia per inviare i segnali, abbiamo progettato meticolosamente un formato di specifiche esclusivo. Questo formato integra perfettamente i placeholder delle strategie di PineScript™, permettendoti di trasmettere i segnali di trading con estrema facilità. Se sei un utente nativo di strategie PineScript™, questo formato è il tuo compagno ideale, in quanto fornisce un approccio semplificato per unire i tuoi script di strategia con i placeholder di strategia di TradingView. Se sei uno scrittore di strategie e utilizzi le funzioni strategiche.*() per creare i tuoi segnali di trading, consulta la Sezione A - per gli utenti di strategie PineScript™ qui sotto.

D'altra parte, sappiamo che non tutti si affidano esclusivamente agli script di strategia PineScript™. Nella Sezione B - Compatibilità universale] di questa guida, forniamo un insieme versatile di specifiche che vanno oltre i metodi di scripting. Queste specifiche sono valide per tutti gli approcci di generazione del segnale. Se utilizzi indicatori personalizzati, varie tecniche grafiche o preferisci gli avvisi manuali, questo quadro di specifiche "taglia unica" ti soddisfa.

Una panoramica espressa di Pine Script™: "Strategia" vs "Indicatore"

Le strategie Pine Script™ servono a condurre backtesting su dati storici e forward test su mercati reali. Oltre a eseguire i calcoli degli indicatori, le strategie includono chiamate alle funzioni di strategia.*() che trasmettono gli ordini di trading InvestmentType all'emulatore di broker di Pine Script™. L'emulatore può quindi simulare l'esecuzione di questi ordini. I risultati dei backtest sono visualizzati nella scheda "Strategy Tester" situata nella parte inferiore del grafico, adiacente alla scheda "Pine Script™ Editor".

Sect A - express overview 1

D'altra parte, anche gli indicatori Pine Script™ comportano dei calcoli, ma non sono destinati all'uso in scenari di backtesting. Grazie alla loro indipendenza dall'emulatore del broker, gli indicatori consumano meno risorse ed eseguono più rapidamente.

Sect A - express overview 2

È importante notare che hai la possibilità di utilizzare il formato della sezione A o quello della sezione B: entrambi sono pienamente compatibili. In base ai messaggi che trasmetti, il sistema riconosce in modo intelligente il formato utilizzato e analizza di conseguenza i tuoi messaggi. Questa elaborazione intelligente garantisce un'esperienza senza soluzione di continuità, indipendentemente dall'approccio scelto.

Sezione A (Utenti di PineScript™ Strategy)

Le seguenti specifiche sono pensate appositamente per gli utenti che compongono i loro algoritmi utilizzando le strategie PineScript™ e principalmente la funzione di strategia.*. Questo formato è dedicato ad accogliere i valori placeholder della strategia, garantendo una perfetta adattabilità. Per una comprensione più approfondita degli script di strategia e del processo di invio degli avvisi utilizzando le variabili placeholder della strategia, puoi trovare ulteriori informazioni a questo link.

Se questo concetto non ti è familiare, la Sezione B fornisce un approccio alternativo per la costruzione dei tuoi avvisi, applicabile a una gamma più ampia di scenari.

Panoramica delle specifiche AlertMsg

Parametro
Obbligatorio
Valori
id
Obbligatorio
  • {{strategy.order.id}} da TradingView

azione
Obbligatorio
  • {{strategy.order.action}} da TradingView

marketPosition
Obbligatorio
  • {{strategy.market_position}} da TradingView

prevMarketPosition
Obbligatorio
  • {{strategy.prev_market_position}} da TradingView

strumento
Obbligatorio
  • {{ticker}} da TradingView

  • Formato InstId da OKX

signalToken
Obbligatorio
Fornito da OKX al momento di creare il segnale
timestamp
Obbligatorio
{{timenow}} da TradingView
maxLag
Opzionale
Valore intero non negativo tra [1, 3600]. Default su 60.
investmentType
Opzionale*


  • base (PER I SEGNALI DI ENTRATA E DI USCITA) Importo in valuta base

  • margine (SOLO PER SEGNALI DI INGRESSO) Margine investito in valuta quotata

  • contratto (SOLO PER LE SEGNALAZIONI DI ENTRATA) Numero fisso di contratti

  • percentage_balance (SOLO PER SEGNALI DI ENTRATA) Basato sulla % del saldo disponibile (cioè il margine disponibile per l'apertura di nuovi ordini)

  • percentage_investment (SOLO PER SEGNALI DI ENTRATA) In base al % di Investimento Attivo nel tuo bot. L'Investimento Attivo sarà tipicamente il tuo margine iniziale investito al momento della creazione del bot e rimarrà fisso fino a quando non ricarichi più margine e decidi di aumentare questo valore.

  • percentage_position (SOLO PER SEGNALI DI USCITA) Basato sulla % delle posizioni aperte

importo
Obbligatorio
  • base (numero fluttuante positivo)

  • margine (numero decimale positivo)

  • contratto (intero positivo)

  • percentage_balance (valore fluttuante tra [0,01, 100] in %)

  • percentage_investment (valore fluttuante compreso tra [0,01, 100] in %)

  • percentage_position (valore fluttuante compreso tra [0,01, 100] in %)

* investmentType sarà predefinito a "percentage_investment" se il segnale è considerato un segnale di entrata e "percentage_position" se il segnale è considerato un segnale di uscita. Tuttavia, si consiglia vivamente di impostare questo valore su "base" e l'importo su "{{strategy.order.contracts}}" per la massima compatibilità con la tua strategia TradingView.

1. Specifica AlertMsg - id

Sect A - id

id - L'identificativo dell'ordine

{{strategy.order.id}} - restituisce l'ID dell'ordine eseguito (la stringa utilizzata come primo parametro in una delle chiamate di funzione che generano ordini: strategy.entry, strategy.exit o strategy.order).

2. Specifica AlertMsg - azione

Sect A - action

azione - Compri o Vendi?

{{strategy.order.action}} - restituisce la stringa "compra" o "vendi" per l'ordine eseguito.

3. Specifiche di AlertMsg - marketPosition

Sect A - marketPosition

marketPosition - Stato della posizione prevista (al momento dell'esecuzione dell'ordine)

{{strategy.market_position}} - restituisce la posizione corrente della strategia in forma di stringa: "in long", "flat” o "in short".

4. Specifiche di AlertMsg - prevMarketPosition

Sect A - prevMarketPosition

prevMarketPosition - Stato della posizione precedente (prima dell'esecuzione dell'ordine)

{{strategy.prev_market_position}} - restituisce la posizione precedente della strategia in forma di stringa: "in long", "flat" o "in short".

5. Specifica AlertMsg - strumento

Sect A - instrument

Formato 1: ticker - valori placeholder di TradingView

Un "placeholder standard"* Una stringa di testo circondata da doppie parentesi quadre e inclusa dentro un messaggio di avviso.

"{{ticker}}" restituirà il ticker dello strumento su cui è stato generato l'avviso.

Ad esempio: "BTCUSDT.P", "ETHUSDT.P".

* Placeholder standard per accedere alle variabili in PineScript™. Ulteriori informazioni qui.

Formato 2: Formato strumento OKX

ID strumento, o "instId " nell'API di OKX. Puoi trovare ulteriori dettagli a questo link

Ad esempio: "BTC-USDT-SWAP", "ETH-USDT-SWAP"

6. Specifica AlertMsg - signalToken

Sect A - signalToken

signalToken -- Autenticazione per Signal

Il token è una misura di sicurezza per garantire che le richieste in arrivo siano legittime e autorizzate. Questo signalToken viene generato automaticamente quando l'utente crea un nuovo segnale sulla nostra piattaforma e deve essere copiato nel messaggio di avviso di TradingView.

Come individuare il proprio signalToken per un segnale già attivo?

  1. Controlla la sezione Dettagli del tuo segnale

Sect A - locate signalToken 1

  1. Individua il tuo signalToken nella sezione dei messaggi di avviso raccomandati

Sect A - locate signalToken 2

7. Specifica AlertMsg - timestamp

Sect A - timestamp

timenow - valori placeholder di TradingView

Un "placeholder standard"* Una stringa di testo circondata da doppie parentesi quadre e inclusa dentro un messaggio di allerta.

"{{timenow}}" restituirà l'ora esatta in cui è stata generata l'avviso, secondo il fuso orario UTC e utilizzando il formato yyyy-MM-ddTHH: mm: ssZ.

Ad esempio: 2023-06-01T17:38:10Z

* Placeholder standard per accedere alle variabili in PineScript. Ulteriori informazioni qui.

8. Specifica AlertMsg - maxLag

Sect A - maxLag

maxLag - Ritardo massimo accettabile

Il termine "maxLag" si riferisce al massimo ritardo o latenza ammissibile, misurato in secondi, prima che un segnale di trading venga considerato nullo. Il calcolo del maxLag consiste nel determinare la differenza di tempo tra il momento in cui il segnale è stato inviato da TradingView (utilizzando il campo "timestamp" all'interno del messaggio di avviso) e l'istante in cui è stato ricevuto su OKX per l'esecuzione di un ordine.

L'impostazione predefinita è 60 secondi. Impostare un valore per maxLag aiuta a garanire che il Signal Bot operi in modo tempestivo, evitando di agire su segnali obsoleti o potenzialmente inaccurati che potrebbero non riflettere più le attuali condizioni di mercato.

9. Specifca AlertMsg - investmentType & importo

Sect A - investmenttype and amount

Nota importante: Per garantire una compatibilità ottimale con la tua strategia TradingView, ti consigliamo di configurare investmentType come "base" e di impostare l'importo a "{{strategy.order.contracts}}". Seguendo questo approccio, le quantità di ordini su OKX si allineeranno con le quantità di ordini specificate nella tua strategia TradingView.

investmentType e Importo

(SOLO PER SEGNALI DI ENTRATA)
  • base: Importo in valuta base (scelta consigliata)

  • margine: Margine investito nella valuta quotata

  • contratto: Un numero fisso di contratti

  • percentage_balance: Basato sulla % di asldo disponibile (ovvero, il margine disponibile per aprire nuovi ordini)

  • percentage_investment: In base al % di Investimento Attivo nel tuo bot. L'Investimento Attivo sarà tipicamente il tuo margine iniziale investito al momento della creazione del bot e rimarrà fisso fino a quando non ricarichi più margine e decidi di aumentare questo valore. Ad esempio, se crei un bot con un margine iniziale investito di 1000 USDT, il tuo Investimento Attivo sarà impostato su 1000 USDT. Per qualsiasi segnale in arrivo, questo è il valore che verrà utilizzato per i calcoli delle dimensioni degli ordini. Supponiamo che dopo qualche giorno di esecuzione del tuo bot, decidi che sta performando bene e reinvesti altri 1000 USDT di margine e li aggiungi al tuo Investimento Attivo. Da quel momento in poi, il tuo Investimento Attivo aumenterà a 2000 USDT e questo sarà il nuovo valore utilizzato per i calcoli delle dimensioni degli ordini. Se non sei sicuro del valore corrente dell'Investimento Attivo del tuo bot, puoi sempre verificarlo nella sezione Dettagli del Bot.

(SOLO PER SEGNALI DI USCITA)
  • base: Importo in valuta base (scelta consigliata)
  • percentage_position: Basato sulla % delle posizioni aperte

Sezione B (compatibilità universale)

Le specifiche riportate di seguito sono versatili e possono essere adattate a qualsiasi scenario. Sia che si utilizzi PineScript™ per creare script di strategie o indicatori (studi), sia che si inseriscano manualmente gli avvisi nell'interfaccia utente Alert di TradingView, queste specifiche rimangono adattabili e personalizzabili.

Panoramica delle specifiche AlertMsg

Parametro Obbligatorio Valori
azione Obbligatorio
  • ENTER_LONG

  • ENTER_SHORT

  • EXIT_LONG

  • EXIT_SHORT

strumento Obbligatorio
  • {{ticker}} da TradingView

  • Formato InstId da OKX

signalToken Obbligatorio Fornito da OKX al momento di creare il segnale
timestamp Obbligatorio {{timenow}} da TradingView
maxLag Opzionale Valore intero non negativo tra [1, 3600]. Default su 60.
orderType Opzionale. Parametro obbligatorio se orderType = Limit
  • mercato

  • limite

orderPriceOffset Opzionale. Il parametro è obbligatorio nel caso in cui non venga configurata nessuna impostazione nel momento in cui si crea il Signal Bot di OKX Valore fluttuante tra [0, 100] in %
investmentType Opzionale. Parametro obbligatorio se orderType = Limit
  • margine (SOLO PER SEGNALI DI INGRESSO) Margine investito in valuta quotata

  • contratto (SOLO PER LE SEGNALAZIONI DI ENTRATA) Numero fisso di contratti

  • percentage_balance (SOLO PER SEGNALI DI ENTRATA) Basato sulla % del saldo disponibile (cioè il margine disponibile per l'apertura di nuovi ordini)

  • percentage_investment (SOLO PER SEGNALI DI ENTRATA) In base al % di Investimento Attivo nel tuo bot. L'Investimento Attivo sarà tipicamente il tuo margine iniziale investito al momento della creazione del bot e rimarrà fisso fino a quando non ricarichi più margine e decidi di aumentare questo valore.

  • percentage_position (SOLO PER SEGNALI DI USCITA) Basato sulla % delle posizioni aperte

importo Opzionale. Parametro obbligatorio se orderType = Limit
  • margine (numero decimale positivo)

  • contratto (intero positivo)

  • percentage_balance (valore fluttuante tra [0,01, 100] in %)

  • percentage_investment (valore fluttuante compreso tra [0,01, 100] in %)

  • percentage_position (valore fluttuante compreso tra [0,01, 100] in %)

1. Specifica AlertMsg - azione

Modalità della posizione:

Il Signal Bot opera in modalità Unidirezionale (ad es Compra/Vendi), il che significa che il bot tratterrà solamente le posizioni in un'unica direzione per un dato strumento.

Ordini aperti
  • ENTER_LONG: Apri una posizione in long con l'aspettativa che il prezzo salirà.
  • ENTER_SHORT: Apri una posizione in short con l'aspettativa che il prezzo scenderà.
Ordini chiusi
  • EXIT_LONG: Chiudi una posizione in long in tutto o in parte vendendo le posizioni detenute.
  • EXIT_SHORT: Chiudi una posizione in short in tutto o in parte ricomprando i contratti.

2. Specifica AlertMsg - strumento

Formato 1: ticker - valori placeholder di TradingView

Un "placeholder standard"* Una stringa di testo circondata da doppie parentesi quadre e inclusa dentro un messaggio di avviso.

"{{ticker}}" restituirà il ticker dello strumento su cui è stato generato l'avviso.

Ad esempio: "BTCUSDT.P", "ETHUSDT.P".

* Placeholder standard per accedere alle variabili in PineScript. Ulteriori informazioni qui.

Formato 2: Formato strumento OKX

ID strumento, o "instId " nell'API di OKX. Puoi trovare ulteriori dettagli a questo link

Ad esempio: "BTC-USDT-SWAP", "ETH-USDT-SWAP"

3. Specifica AlertMsg - signalToken

signalToken - Autenticazione per Signal

Il token è una misura di sicurezza per garantire che le richieste in arrivo siano legittime e autorizzate. Questo signalToken viene generato automaticamente quando l'utente crea un nuovo segnale sulla nostra piattaforma e deve essere copiato nel messaggio di avviso di TradingView.

4. Specifica AlertMsg - timestamp

timenow - valori placeholder di TradingView

Un "placeholder standard"* Una stringa di testo circondata da doppie parentesi quadre e inclusa dentro un messaggio di avviso.

"{{timenow}}" restituirà l'ora esatta in cui è stata generata l'avviso, secondo il fuso orario UTC e utilizzando il formato yyyy-MM-ddTHH: mm: ssZ.

Formattazione possibile (ora UTC, formato ISO 8061)

  • formato yyyy-MM-ddTHH:mm:ssZ Ad esempio: 2023-06-01T17:38:10Z
  • formato yyyy-MM-ddTHH:mm:ss.SSSZ Ad esempio: "2023-06-01T17:38:10.836Z"
  • formato yyyy-MM-ddTHH:mm:ss+0000 Ad esempio: "2023-06-01T17:38:10+0000"

Ad esempio: 2023-06-01T17:38:10Z

* Placeholder standard per accedere alle variabili in PineScript. Ulteriori informazioni qui.

5. Specifica AlertMsg - maxLag

maxLag - Ritardo massimo accettabile

Il termine "maxLag" si riferisce al massimo ritardo o latenza ammissibile, misurato in secondi, prima che un segnale di trading venga considerato nullo. Il calcolo del maxLag consiste nel determinare la differenza di tempo tra il momento in cui il segnale è stato inviato da TradingView (utilizzando il campo "timestamp" all'interno del messaggio di avviso) e l'istante in cui è stato ricevuto su OKX per l'esecuzione di un ordine.

L'impostazione predefinita è 60 secondi. Impostare un valore per maxLag aiuta a garanire che il Signal Bot operi in modo tempestivo, evitando di agire su segnali obsoleti o potenzialmente inaccurati che potrebbero non riflettere più le attuali condizioni di mercato.

6. Specifica AlertMsg - ordine

orderType

  • Mercato: Piazza un ordine di mercato per aprire (se l'azione =ENTER_XX) o chiudere (se l'azione = EXIT_XX) una posizione. Non c'è bisogno di indicare orderPriceOffset
  • Limite: Piazza un ordine di limite per aprire (se l'azione =ENTER_XX) o chiudere (se l'azione = EXIT_XX) una posizione.

orderPriceOffset (applicabile SOLAMENTE con ordine LIMITE)

  • 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. Specifca AlertMsg - investmentType & importo

investmentType e Importo

(SOLO PER SEGNALI DI ENTRATA)
  • Margine: Margine investito nella valuta quotata

  • Contratto: Un numero fisso di contratti

  • Percentage_balance: Basato sulla % di asldo disponibile (ovvero, il margine disponibile per aprire nuovi ordini)

  • Percentage_investment: In base al % di Investimento Attivo nel tuo bot. L'Investimento Attivo sarà tipicamente il tuo margine iniziale investito al momento della creazione del bot e rimarrà fisso fino a quando non ricarichi più margine e decidi di aumentare questo valore. Ad esempio, se crei un bot con un margine iniziale investito di 1000 USDT, il tuo Investimento Attivo sarà impostato su 1000 USDT. Per qualsiasi segnale in arrivo, questo è il valore che verrà utilizzato per i calcoli delle dimensioni degli ordini. Supponiamo che dopo qualche giorno di esecuzione del tuo bot, decidi che sta performando bene e reinvesti altri 1000 USDT di margine e li aggiungi al tuo Investimento Attivo. Da quel momento in poi, il tuo Investimento Attivo aumenterà a 2000 USDT e questo sarà il nuovo valore utilizzato per i calcoli delle dimensioni degli ordini. Se non sei sicuro del valore corrente dell'Investimento Attivo del tuo bot, puoi sempre verificarlo nella sezione Dettagli del Bot.

(SOLO PER SEGNALI DI USCITA)
  • Percentage_position: Basato sulla % delle posizioni aperte

Esempi Sezione B

Esempio 1: Entrata in long - Uscita in long (chiusura completa) senza entrata multipla

Esempio 2: Entrata in long -> Entrata in short (Inversione in un solo passaggio) senza entrata multipla

Esempio 3: Entrata in long -Uscita in long (parziale) - Uscita in long (chiusura completa)

Esempio 4: Utilizzando un'entrata multipla

Entrata multipla è una funzionalità in Signal Bot che permette l'esecuzione di molteplici punti di ingresso per un dato strumento. I trader possono ottimizzare il loro approccio di trading diversificando i punti di ingresso (ad esempio tramite un PAC), aumentando potenzialmente le opportunità di cogliere operazioni redditizie in un ambiente di mercato dinamico.

Esempio 5: Utilizzando solo il segnale trigger (senza campi relativi all'ordine)

I fornitori di segnali potrebbero escludere alcuni parametri opzionali, poiché l'utente li ha già configurati nel bot. Ciò si rivela utile soprattutto per i fornitori che si concentrano sull'offerta ESCLUSIVA di segnali trigger di Acquisto/Vendita, e sta al singolo sottoscrittore decidere quanto investire.

Esempio 6: Utilizzando solo il segnale trigger (senza campi relativi all'ordine)

Se né il segnale né la configurazione del bot specificano i dettagli dell'ordine, verranno utilizzati dei valori definiti.

  • Per i segnali di ENTRATA, come impostazione predefinita aprirà X%* investimenti utilizzando l'ordine di mercato.
  • Per segnali di USCITA, chiuderà il 100% delle posizioni aperte nel momento in cui riceve il segnale.

*** X = 100 per coppia singola. X = 50 per coppia multipla

Esempio 7: Precedenza dell'ordine di campo

I parametri dei bot hanno la precedenza sui parametri del segnale. Ci sono due regole da tenere a mente:

  1. Regola 1: Sia il Bot che il Segnale definiscono il campo
Per tipo di ordine
Ordine di mercato (Bot) ✅
Ordine limite (Segnale) ❌
  1. Regola 2: Uno tra Bot e Segnale definisce il campo
Per Tipo di investimento e Importo
N/A (Bot) ❌
100% del saldo disponibile (Segnale)✅

##Domande frequenti
Se hai domande relative a Signal Bot, puoi consultare alcune delle domande più frequenti poste dai nostri utenti in questo articolo.