WebSocket API v1 - Cum să mențineți un registru de ordine valid

După abonarea la fluxul registrului de ordine, primul mesaj de date de piață va fi un instantaneu al registrului de ordine actual.

Instantaneul registrului de ordine include întregul registru de ordine până la adâncimea solicitată (abonată), cum ar fi următorul exemplu al registrului de ordine XBT/USD la o adâncime de 10:

[0,{"as":[["5290.80000","1.00000000","1556724667.748660"],["5290.90000","4.49956524","1556724664.331028"],["5291.70000","1.00000000","1556724653.480504"],["5292.00000","0.95388940","1556724619.682690"],["5292.20000","1.51300000","1556724494.497326"],["5293.10000","0.69800000","1556724667.635414"],["5293.20000","2.00000000","1556724656.022756"],["5293.90000","2.83200000","1556724668.057687"],["5294.10000","0.99600000","1556724666.340462"],["5294.50000","5.00000000","1556724661.980996"]],"bs":[["5290.10000","1.43195600","1556724666.594179"],["5289.80000","2.00000000","1556724663.082526"],["5289.40000","0.49400000","1556724665.274827"],["5289.20000","0.89533312","1556724640.520134"],["5287.40000","3.23600000","1556724660.997516"],["5287.30000","3.33000000","1556724659.999108"],["5287.00000","10.20000000","1556724635.850932"],["5286.00000","3.86378703","1556724662.757360"],["5285.70000","6.40000000","1556724488.785281"],["5283.90000","0.50000000","1556723616.006805"]]},"book-10","XBT/USD"]

Instantaneul include cele mai bune prețuri curente de cumpărare/vânzare, cu volumele lor disponibile, și data/ora la care nivelul de preț a fost actualizat cel mai recent (ca un marcaj temporal UNIX în secunde, cu 6 zecimale).

Modificări ale Nivelului de Preț

După instantaneul inițial, nivelurile de preț ale registrului de ordine sunt modificate în timp real prin mesaje de actualizare, inserare și ștergere.

Mesaje de Actualizare

Un mesaj de actualizare modifică un nivel de preț care există deja în registrul de ordine, furnizând un nou volum și un marcaj temporal, cum ar fi următoarea actualizare pentru nivelul de preț 5293.1 pe partea de vânzare a registrului de ordine:

[0,{"a":[["5293.10000","0.39800000","1556724673.104421"]], "c":"408163318"},"book-10","XBT/USD"]

În timp ce prețul rămâne același (5293.1), volumul disponibil la acel preț este modificat de la 0.69800000 (așa cum a fost furnizat de instantaneul inițial) la 0.39800000, iar noul marcaj temporal pentru nivelul de preț reflectă data/ora la care a avut loc modificarea.

Mesajele de actualizare modifică doar nivelurile de preț care există deja în registrul de ordine; ele nu adaugă sau elimină niveluri de preț din registrul de ordine.

Mesaje de Inserare

Un mesaj de inserare adaugă un nou nivel de preț în registrul de ordine, cum ar fi următoarea inserare pentru nivelul de preț 5294.4 pe partea de vânzare a registrului de ordine:

[0,{"a":[["5294.40000","0.99600000","1556724672.663220"]], "c":"393966308"},"book-10","XBT/USD"]

Fiecare mesaj de inserare include noul nivel de preț (5294.4), volumul disponibil la acel preț (0.99600000) și marcajul temporal la care nivelul de preț a fost actualizat cel mai recent.

Mesajele de inserare modifică nivelurile de preț din registrul de ordine prin crearea unui nou nivel de preț, mutând toate nivelurile de preț ulterioare (prețuri de cumpărare mai mici sau prețuri de vânzare mai mari) spre exterior și împingând nivelul de preț cel mai exterior în afara domeniului de aplicare al registrului de ordine.

De exemplu, din instantaneul inițial de mai sus, mesajul de inserare:

[0,{"a":[["5294.40000","0.99600000","1556724672.663220"]], "c":"393966308"},"book-10","XBT/USD"]

Ar adăuga nivelul de preț 5294.4 în registrul de ordine la nivelul 10 (cel mai mare preț de vânzare) și ar muta nivelul de preț 5294.5 în afara domeniului de aplicare al registrului de ordine (mutând efectiv 5294.5 la nivelul 11).

Mesaje de Ștergere

Un mesaj de ștergere elimină un nivel de preț din registrul de ordine, cum ar fi următorul mesaj parțial de ștergere pentru nivelul de preț 5294.1 pe partea de vânzare a registrului de ordine:

[0,{"a":[["5294.10000","0.00000000","1556724670.010241"]] ... },"book-10","XBT/USD"]

Mesajele de ștergere includ nivelul de preț care nu mai există, specifică întotdeauna un volum disponibil de 0.0 și includ un marcaj temporal care indică data/ora la care nivelul de preț a fost eliminat din registrul de ordine.

Mesajele de ștergere modifică nivelurile de preț din registrul de ordine prin eliminarea nivelului de preț afectat (din registrul de ordine în întregime, nu doar din adâncimea abonată), mutând toate nivelurile de preț ulterioare (prețuri de cumpărare mai mici sau prețuri de vânzare mai mari) spre interior și atrăgând un nou nivel de preț în domeniul de aplicare al registrului de ordine.

Rețineți că o ștergere este întotdeauna urmată imediat de o inserare care aduce un nou nivel de preț în domeniul de aplicare la nivelul cel mai exterior (cum ar fi nivelul 10 pentru o adâncime abonată de 10).

De exemplu, din instantaneul inițial de mai sus, mesajul de ștergere/inserare:

[0,{"a":[["5294.10000","0.00000000","1556724670.010241"],["5294.70000","3.34000000","1556724653.951982","r"]], "c":"3679121060"},"book-10","XBT/USD"]

Acest lucru ar șterge nivelul de preț 5294.1 de la nivelul 9 al registrului de ordine, ar muta nivelul de preț 5294.5 de la nivelul 10 la nivelul 9 și ar adăuga imediat noul nivel de preț 5294.7 la nivelul 10 al registrului de ordine (nivelul cel mai exterior și cel mai mare preț de vânzare pentru o adâncime de 10).

Resurse Suplimentare

Detalii suplimentare despre logica registrului de ordine sunt disponibile printr-o transcriere eșantion a registrului de ordine și un cod exemplu care implementează clienți de linie de comandă asincroni (multi-thread) și sincroni (single-thread).

Separatoarele zecimale și de mii afișate în acest articol pot diferi de formatele afișate pe platformele noastre de tranzacționare. Consultați articolul nostru despre cum utilizăm punctele și virgulele pentru mai multe informații.