Specificațiile mesajului de alertă ale semnalului de tranzacționare Bot 2.0

Cuprins

• Introducere

• Secțiunea A - pentru utilizatorii Strategiei PineScript

• Secțiunea B - cu compatibilitate universală

• Întrebări frecvente

Introducere

Odată cu lansarea opțiunii Bot de semnale, utilizatorii Vizualizarea Tranzacției pot să își publice semnalele și să creeze un Bot de semnale pe OKX. În acest ghid, vom trece în revistă diferitele specificații ale mesajelor de alertă pe care OKX le suportă pentru utilizatori.

Pentru cei care stăpânesc PineScript și se bazează exclusiv pe scripturi de strategie pentru a trimite semnale, am proiectat cu meticulozitate un format exclusiv de specificații. Acest format se integrează perfect în spațiile Strategiei PineScript, permițându-vă să transmiteți semnale de tranzacționare foarte ușor. Dacă sunteți utilizator nativ al strategiei PineScript, acest format este partenerul dvs. ideal, oferindu-vă o abordare simplificată pentru a îmbina scripturile de strategie cu spațiile Strategiei Vizualizarea Tranzacției. Dacă sunteți autor de strategii și folosiți funcțiile strategy.*() pentru a vă construi semnalele de tranzacționare, consultați Secțiunea A - pentru utilizatorii strategiei PineScript de mai jos.

Pe de altă parte, înțelegem că nu toată lumea se bazează doar pe scripturile Srategiei PineScript. În Secțiunea B - cu compatibilitate universală din acest ghid, oferim un set versatil de specificații care depășesc metodele de scripting. Aceste specificații sunt valabile pentru toate metodele de generare a semnalelor. Indiferent dacă folosiți indicatori personalizați, diverse tehnici grafice sau chiar dacă preferați alertele manuale, acest cadru de specificații „universal” răspunde nevoilor dvs.

Prezentare sumară a Pine Script: „Strategy” contra „Indicator”

Strategiile Pine Script servesc la efectuarea de teste retrospective de date istorice, precum și la testarea în perspectivă pe piețele reale. Pe lângă efectuarea calculelor indicatorilor, strategiile includ apeluri la funcțiile strategy.*() care transmit ordinele de tranzacții către emulatorul de broker al Pine Script. Acest emulator poate apoi să simuleze executarea acestor ordine. Rezultatele testelor retrospective se vizualizează în fila „Strategy Tester”, situată în partea de jos a graficului, lângă fila „Pine Script Editor”.

Pe de altă parte, indicatorii Pine Script implică, de asemenea, calcule, dar nu sunt destinați utilizării în scenariile de teste retrospective. Datorită independenței lor față de emulatorul brokerului, indicatorii consumă mai puține resurse și se execută mai rapid.

Este important să rețineți că aveți flexibilitatea de a utiliza fie formatul din Secțiunea A, fie cel din Secțiunea B - ambele sunt pe deplin compatibile. Pe baza mesajelor pe care le transmiteți, sistemul va discerne în mod inteligent formatul utilizat și va analiza mesajele în mod corespunzător. Această procesare inteligentă asigură o experiență unitară, indiferent de abordarea aleasă.

Secțiunea A (utilizatorii Strategiei PineScript)

Următoarele specificații sunt special concepute pentru utilizatorii care își compun algoritmii folosind strategiile PineScript și, în principal, funcția strategy.*. Acest format este dedicat includerii valorilor spațiilor de strategie, asigurând o adaptabilitate fără cusur. Pentru o înțelegere mai profundă a scripturilor de strategie și a procesului de trimitere a alertelor folosind variabilele de strategie, puteți găsi informații suplimentare la acest link.

Dacă acest concept nu vă este familiar, Secțiunea B oferă o abordare alternativă pentru construirea alertelor dvs., aplicabilă unei game mai largi de scenarii.

Prezentarea specificațiilor AlertMsg

1. Specificația AlertMsg - id

id - Identificatorul ordinului

{{strategy.order.id}} - restituie ID-ul ordinului executat (șirul de caractere utilizat ca prim parametru în unul dintre apelurile funcțiilor care generează ordine: strategy.entry, strategy.exit sau strategy.order).

2. Specificația AlertMsg - acțiune

acțiune - cumpărați sau vindeți?

{{strategy.order.action}} - returnează șirul de caractere „cumpărați” sau „vindeți” pentru ordinul executat.

3. Specificație AlertMsg - poziția pieței

Poziția pieței - Starea intenționată a poziției (la executarea ordinului).

{{strategy.market_position}} - returnează poziția curentă a strategiei sub formă de șir de caractere: „long”, „flat”, or „short”.

4. Specificația AlertMsg - Poziția pieței anterioară

Poziția pieței - Starea anterioară a poziției (înainte de executarea ordinului)

{{strategy.prev_market_position}} - returnează poziția anterioară a strategiei sub formă de șir de caractere: „long”, „flat”, or „short”.

5. Specificație AlertMsg - instrument

Format 1: ticker - Valori substitut Vizualizarea Tranzacției

Un "substitut standard "* este o bucată de text literal înconjurată de paranteze duble și inclusă într-un mesaj de alertă.

"{{ticker}}" va returna Ticker-ul instrumentului pentru care a fost generată alerta.

De exemplu: „BTCUSDT.P”, „ETHUSDT.P”.

*Substitut standard pentru a accesa variabile în PineScript. Aflați mai multe aici.

Formatul 2: Formatul instrumentului OKX

ID Instrument sau instId în OKX API. Mai multe detalii se pot afla în acest link.

De exemplu: „BTC-USDT-SWAP”, „ETH-USDT-SWAP”

6. Specificația AlertMsg - Token semnal

Token semnal -- Autentificare pentru semnal

Tokenul este o măsură de securitate pentru a se asigura că solicitările primite sunt legitime și autorizate. Acest Token semnal va fi generat automat atunci când utilizatorul creează cu succes un nou semnal pe platforma noastră și trebuie copiat în mesajul de alertă Vizualizarea tranzacției.

Cum localizați Tokenul semnalului pentru un semnal deja activ?

1. Verificați secțiunea Detalii a semnalului dvs.

2. Localizați Tokenul semnalului dvs. în secțiunea de mesaje de alertă recomandate

7. Specificație AlertMsg - marcaj de timp

timenow - valori substitut Vizualizarea Tranzacției

Un „substitut standard”* este o bucată de text literal înconjurată de paranteze duble și inclusă într-un mesaj de alertă.

"{{timenow}}" va reda ora curentă și exactă a momentului în care a fost generată alerta, în format UTC și aaaa-LL-zzTHH: mm: ssZ.

De exemplu: „2023-06-01T17:38:10Z”

*Substitut standard pentru a accesa variabile în PineScript. Aflați mai multe aici.

8. Specificație AlertMsg - maxLag

maxLag - întârzierea maximă acceptabilă

Termenul „maxLag” se referă la cea mai mare întârziere sau latență permisă, măsurată în secunde, înainte ca un semnal de tranzacționare să fie considerat nul. Acest calcul al maxLag implică determinarea diferenței de timp dintre momentul în care semnalul a fost trimis de Vizualizarea Tranzacției (utilizând câmpul „timestamp” din mesajul de alertă) și momentul în care a fost primit pe OKX în scopul executării unui ordin.

În mod implicit, acesta este setat la 60 de secunde. Setarea unei valori maxLag ajută la asigurarea faptului că Botul de semnal funcționează în timp util, evitând să acționeze pe baza unor semnale învechite sau potențial inexacte, care ar putea să nu mai reflecte condițiile actuale ale pieței.

9. Specificație AlertMsg - Tipul investiției & suma

Observație importantă: Pentru a asigura o compatibilitate optimă cu strategia dvs. de Vizualizarea Tranzacției, vă recomandăm să configurați tipul investiției ca fiind „bază” și să setați suma la „{{strategy.order.contracts}}”. Urmând această abordare, cantitățile de ordine de pe OKX se vor alinia cu cantitățile de ordine specificate în strategia dvs. de Vizualizarea Tranzacției.

Tipul investiției și suma

(NUMAI PENTRU SEMNALE DE INTRARE)

• bază: Suma în moneda de bază (alegere recomandată)

• marjă: Marja investită în moneda de cotație

• contract: Un număr fix de contracte

• sold_procentual: Pe baza % din Soldul disponibil (adică marja disponibilă pentru deschiderea de noi comenzi)

• investiție_procentuală: Pe baza procentului de Investiție Activă în botul tău. Investiția Activă va fi în mod obișnuit marja investită inițial la momentul creării botului și rămâne fixă până când adaugi mai multă marjă și alegi să o crești. De exemplu, dacă creezi un bot cu o marjă investită inițială de 1000 USDT, Investiția Activă va fi setată la 1000 USDT. Pentru orice semnal primit, acesta este valoarea care va fi folosită pentru calculul mărimii comenzii tale. Să zicem că, după câteva zile de funcționare a botului tău, decizi că se descurcă bine și reinvestești încă 1000 USDT marjă și o adaugi la Investiția Activă. În consecință, Investiția Activă va crește la 2000 USDT și aceasta este noua valoare care va fi folosită pentru calculul mărimii comenzii tale. Dacă nu ești sigur care este valoarea curentă a Investiției Active a botului tău, o poți verifica întotdeauna în secțiunea Detalii Bot ale tale.

(NUMAI PENTRU SEMNALELE DE IEȘIRE)

• bază: Suma în moneda de bază (alegere recomandată)
• poziție_procentuală: În baza a % din poziția deschisă

Secțiunea B (cu compatibilitate universală)

Specificațiile furnizate mai jos sunt versatile și pot fi adaptate pentru a se potrivi oricărui scenariu. Fie că utilizați PineScript pentru elaborarea de scripturi de strategie sau de indicator (studiu), fie că introduceți manual alerte în interfața utilizatorului de alertă la Vizualizarea Tranzacției, aceste specificații rămân adaptabile și personalizabile.

Prezentarea specificațiilor AlertMsg

1. Specificația AlertMsg - acțiune

Modul poziției:

Botul de semnale funcționează în modul unidirecțional (de exemplu, cumpărare/vânzare), ceea ce înseamnă că botul va menține poziții doar într-o singură direcție pentru un anumit instrument.

Deschideți ordine

• ENTER_LONG: Deschideți o poziție Lung cu speranța că prețul va crește.
• ENTER_SHORT: Deschideți o poziție Scurt cu speranța că prețul său va scădea.

Închideți ordine

• EXIT_LONG: Închideți o poziție Lung parțial sau integral prin vânzarea pozițiilor deținute.
• EXIT_SHORT: Închideți o poziție Scurt parțial sau complet prin răscumpărarea contractelor.

2. Specificație AlertMsg - instrument

Format 1: ticker - Valori substitut Vizualizarea Tranzacției

Un „substitut standard”* este o bucată de text literal înconjurată de paranteze duble și inclusă într-un mesaj de alertă.

"{{ticker}}" va returna Ticker-ul instrumentului pentru care a fost generată alerta.

De exemplu: „BTCUSDT.P”, „ETHUSDT.P”.

*Substitut standard pentru a accesa variabile în PineScript. Aflați mai multe aici.

Formatul 2: Formatul instrumentului OKX

ID Instrument sau instId în OKX API. Mai multe detalii se pot afla în acest link.

De exemplu: „BTC-USDT-SWAP”, „ETH-USDT-SWAP”

3. Specificația AlertMsg - Token semnal

Token semnal - Autentificare pentru semnal

Tokenul este o măsură de securitate pentru a se asigura că solicitările primite sunt legitime și autorizate. Acest Token semnal va fi generat automat atunci când utilizatorul creează cu succes un nou semnal pe platforma noastră și trebuie copiat în Mesajul de alertă Vizualizarea tranzacției.

4. Specificație AlertMsg - marcaj de timp

timenow - valori substitut Vizualizarea Tranzacției

Un „substitut standard”* este o bucată de text literal înconjurată de paranteze duble și inclusă într-un mesaj de alertă.

"{{timenow}}" va reda ora curentă și exactă a momentului în care a fost generată alerta, în format UTC și aaaa-LL-zzTHH: mm: ssZ.

Formatare posibilă (ora UTC, formatul ISO 8061)

• formatul aaaa-ll-zzTHH:mm:ssZ De exemplu: „2023-06-01T17:38:10Z”
• formatul aaaa-ll-zzTHH:mm:ss.SSSZ De exemplu: „2023-06-01T17:38:10.836Z”
• formatul aaaa-ll-zzTHH:mm:ss.SSSZ De exemplu: „2023-06-01T17:38:10+0000”

De exemplu: „2023-06-01T17:38:10Z”

*Substitut standard pentru a accesa variabile în PineScript. Aflați mai multe aici.

5. Specificație AlertMsg - maxLag

maxLag - întârzierea maximă acceptabilă

Termenul „maxLag” se referă la cea mai mare întârziere sau latență permisă, măsurată în secunde, înainte ca un semnal de tranzacționare să fie considerat nul. Acest calcul al maxLag implică determinarea diferenței de timp dintre momentul în care semnalul a fost trimis de Vizualizarea Tranzacției (utilizând câmpul „timestamp” din mesajul de alertă) și momentul în care a fost primit pe OKX în scopul executării unui ordin.

În mod implicit, acesta este setat la 60 de secunde. Setarea unei valori maxLag ajută la asigurarea faptului că Botul de semnal funcționează în timp util, evitând să acționeze pe baza unor semnale învechite sau potențial inexacte, care ar putea să nu mai reflecte condițiile actuale ale pieței.

6. Specificația AlertMsg - ordin

Tipul ordinului

• Piață: Plasați un ordin la prețul pieței pentru a Deschide (dacă acțiunea =INTRAREXX) sau a Închide (dacă acțiunea = IEȘIREXX) o poziție. Nu este necesar să furnizați compensare Preț Ordin
• Limită: Plasați un ordin limită pentru a Deschide (dacă acțiunea =INTRAREXX) sau a Închide (dacă acțiunea = IEȘIREXX) o poziție.

compensare Preț Ordin (se aplică NUMAI în cazul ordinului LIMITĂ)

• ENTER_LONG: [1-(compensare Preț Ordin/100)] * Oferta-1
• ENTER_SHORT: [1+(compensare Preț Ordin/100)] * Cerere-1
• EXIT_LONG: [1+(compensare Preț Ordin/100)] * Cerere-1
• EXIT_SHORT: [1-(compensare Preț Ordin/100)] * Oferta-1

7. Specificație AlertMsg - Tipul investiției & suma

Tipul investiției și suma

(NUMAI PENTRU SEMNALE DE INTRARE)

• Marjă: Marja investită în moneda de cotație

• Contract: Un număr fix de contracte

• sold_procentual: Pe baza % din Soldul disponibil (adică marja disponibilă pentru deschiderea de noi comenzi)

• investiție_procentuală: Pe baza procentului de Investiție Activă în botul tău. Investiția Activă va fi în mod obișnuit marja investită inițial la momentul creării botului și rămâne fixă până când adaugi mai multă marjă și alegi să o crești. De exemplu, dacă creezi un bot cu o marjă investită inițială de 1000 USDT, Investiția Activă va fi setată la 1000 USDT. Pentru orice semnal primit, acesta este valoarea care va fi folosită pentru calculul mărimii comenzii tale. Să zicem că, după câteva zile de funcționare a botului tău, decizi că se descurcă bine și reinvestești încă 1000 USDT marjă și o adaugi la Investiția Activă. În consecință, Investiția Activă va crește la 2000 USDT și aceasta este noua valoare care va fi folosită pentru calculul mărimii comenzii tale. Dacă nu ești sigur care este valoarea curentă a Investiției Active a botului tău, o poți verifica întotdeauna în secțiunea Detalii Bot ale tale.

(NUMAI PENTRU SEMNALELE DE IEȘIRE)

• Poziție_procentuală: În baza a % din pozițiile deschise

Secțiunea B Exemple de lucru

Exemplul 1: Intrare Lung -> Ieșire Lung (închidere completă) fără Multi-Entry

Exxemplul 2: Intrare Lung -> Intrare Scurt (inversare dintr-un pas) fără Multi-Entry

Exemplul 3: Intrare Lung -> Ieșire Lung (Parțial) -> Ieșire Lung (închidere completă)

Exemplul 4: Folosirea opțiunii Multi-Entry

Intrarea multiplă este o caracteristică din Botul de semnal care permite executarea mai multor puncte de intrare pentru un anumit instrument. Traderii își pot optimiza abordarea de tranzacționare prin diversificarea punctelor de intrare (de exemplu, Dollar-Cost Averaging), crescând potențial șansele de a obține tranzacții profitabile într-un mediu de piață dinamic.

Exemplul 5: Utilizarea doar a semnalului de declanșare (fără câmpuri legate de ordin)

În cazul furnizorilor de semnale, aceștia pot exclude anumiți parametri opționali, având în vedere că utilizatorul i-a configurat deja în bot.Acest lucru este deosebit de util pentru furnizorii care se concentrează NUMAI pe oferirea de semnale de declanșare de Cumpărare/Vânzare, iar fiecare subscriitor poate decide cât de mult investește.

Exemplul 6: Utilizarea doar a semnalului de declanșare (fără câmpuri legate de ordin)

În cazul în care atât semnalul, cât și configurația botului nu specifică detaliile ordinului, vor fi utilizate valorile implicite.

• Pentru semnalele INTRARE, în mod implicit se va deschide X%* investiție folosind ordinul la prețul pieței.
• Pentru semnalele IEȘIRE, în mod implicit, va închide 100% din pozițiile deschise la primirea semnalului.

*** X = 100 pentru pereche unică. X = 50 pentru pereche multiplă

Exemplul 7: Precedența ordinii câmpurilor

Parametrii Bot au prioritate față de parametrii de semnal. Trebuie să țineți cont de două reguli:

1. Regula 1: Atât Bot cât și Semnal definesc câmpul

2. Regula 2: Unul dintre Bot/Semnal definește câmpul

Întrebări frecvente

Dacă aveți întrebări referitoare la Botul Semnal, puteți consulta unele dintre cele mai frecvente întrebări puse de utilizatorii noștri în acest articol.