Specifiche del messaggio di avviso di Trading Signal Bot 2.0
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".
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.
È 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
|
|
|
azione
|
Obbligatorio
|
|
|
marketPosition
|
Obbligatorio
|
|
|
prevMarketPosition
|
Obbligatorio
|
|
|
strumento
|
Obbligatorio
|
|
|
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*
|
|
|
importo
|
Obbligatorio
|
|
1. Specifica AlertMsg - 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
azione - Compri o Vendi?
{{strategy.order.action}} - restituisce la stringa "compra" o "vendi" per l'ordine eseguito.
3. Specifiche di AlertMsg - 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
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
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
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?
- Controlla la sezione Dettagli del tuo segnale
- Individua il tuo signalToken nella sezione dei messaggi di avviso raccomandati
7. 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 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
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
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 |
|
| strumento | Obbligatorio |
|
| 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 |
|
| 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 |
|
| importo | Opzionale. Parametro obbligatorio se orderType = Limit |
|
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:
- Regola 1: Sia il Bot che il Segnale definiscono il campo
|
Per tipo di ordine
|
Ordine di mercato (Bot) ✅
|
Ordine limite (Segnale) ❌
|
- 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.