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

Publicat la 30 aug. 2023Actualizat la 3 iul. 202419 min citire

Cuprins

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”.

Sect A - prezentare sumară 1

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.

Sect A - prezentare sumară 2

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

Parametru
necesare
Valori
id
Necesare
  • {{strategy.order.id}} din Vizualizarea Tranzacției

action
Required
  • {{strategy.order.action}} din Vizualizarea tranzacțiilor

Poziția pieței
Required
  • {{strategy.market_position}} din Vizualizarea Tranzacției

Poziția pieței anterioară
Necesare
  • {{strategy.prev_market_position}} din Vizualizarea Tranzacției

instrument
Necesare
  • {{ticker}} din Vizualizarea tranzacțiilor

  • Format instalat din OKX

Token semnal
Necesare
furnizat de OKX la crearea semnalului
marcaj de timp
Necesare
{{timenow}}
din Vizualizarea tranzacțiilor
maxLag
Opțional
Valoare integrală nenegativă cuprinsă între [1, 3600]. Implicit la 60.
Tipul investiției
Opțional*


  • bază (PENTRU SEMNALE DE INTRARE ȘI IEȘIRE) Suma în moneda de bază

  • marjă (NUMAI PENTRU SEMNALE DE INTRARE) Marjă investită în moneda de cotație

  • contract (NUMAI PENTRU SEMNALE DE INTRARE) Număr fix de contracte

  • sold_procentual (DOAR PENTRU SEMNALE DE INTRARE) Bazat pe % din soldul disponibil (de exemplu, marja disponibilă pentru deschiderea de noi ordine)

  • investiție_procentuală (DOAR PENTRU SEMNALE DE INTRARE) 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.

  • poziție_procentuală (DOAR PENTRU SEMNALE DE IEȘIRE) Bazat pe % din poziția deschisă

suma
Necesare
  • bază (număr variabil pozitiv)

  • marjă (număr variabil pozitiv)

  • contract (întreg pozitiv)

  • sold_procent (valoare variabilă cuprinsă între [0,01, 100] în %)

  • procentaj_investiție (valoare variabilă între [0,01, 100] în %)

  • procent_poziție (valoare variabilă între [0,01, 100] în %)

* investmentType va fi implicit la "percentage_investment" în cazul în care semnalul este considerat semnal de intrare și "percentage_position" în cazul în care semnalul este considerat semnal de ieșire. Cu toate acestea, se recomandă insistent ca această valoare să fie setată la "base" și suma să fie setată la "{{strategy.order.contracts}}" pentru compatibilitate maximă cu strategia dvs. de Viualizarea Tranzacțiilor.

1. Specificația AlertMsg - id

Secț A - 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

Secț A - 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

Secț A - 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ă

Secț A - 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

Secț A - 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

Secț A - 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.

Secț A - localizați Tokenul semnalului 1

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

Secț A - localizați Tokenul semnalului 2

7. Specificație AlertMsg - marcaj de timp

Secț A - 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

Secț A - 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

Secț A - tipul investiției și 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

Parametru necesare Valori
acțiune Necesare
  • ENTER_LONG

  • ENTER_SHORT

  • EXIT_LONG

  • EXIT_SHORT

instrument Necesare
  • {{ticker}} din Vizualizarea Tranzacției

  • Format instalat din OKX

Token semnal Necesare furnizat de OKX la crearea semnalului
marcaj de timp Necesare {{timenow}} din Vizualizarea Tranzacției
maxLag Opțional Valoare integrală nenegativă cuprinsă între [1, 3600]. Implicit la 60.
Tipul ordinului Opțional. Parametrul este necesar dacă Tipul ordinului = Limită
  • piața

  • limită

compensare Preț Ordin Opțional. Parametrul este necesar dacă nu sunt configurate setări la crearea Bot de semnal OKX Valoare variabilă cuprinsă între [0, 100] în %
Tipul investiției Opțional. Parametrul este necesar dacă Tipul ordinului = Limită
  • marjă (NUMAI PENTRU SEMNALE DE INTRARE) Marjă investită în moneda de cotație

  • contract (NUMAI PENTRU SEMNALE DE INTRARE) Număr fix de contracte

  • sold_procentual (DOAR PENTRU SEMNALE DE INTRARE) Bazat pe % din soldul disponibil (de exemplu, marja disponibilă pentru deschiderea de noi ordine)

  • investiție_procentuală (DOAR PENTRU SEMNALE DE INTRARE) 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.

  • poziție_procentuală (DOAR PENTRU SEMNALE DE IEȘIRE) Bazat pe % din poziția deschisă

suma Opțional. Parametrul este necesar dacă Tipul ordinului = Limită
  • marjă (număr variabil pozitiv)

  • contract (întreg pozitiv)

  • sold_procent (valoare variabilă cuprinsă între [0,01, 100] în %)

  • procentaj_investiție (valoare variabilă între [0,01, 100] în %)

  • procent_poziție (valoare variabilă între [0,01, 100] în %)

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
Pentru Tipul ordinului
Ordin la prețul pieței (Bot) ✅
Ordin limită (Semnal) ❌
  1. Regula 2: Unul dintre Bot/Semnal definește câmpul
Pentru tipul investiției și suma
Nu se aplică (Bot) ❌
100% sold disponibil (Semnal) ✅

Î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.