WebSocket API v1 – Příklad přepisu knihy objednávek

Poslední aktualizace: 1. dubna 2025

Příklad přepisu kanálu knihy objednávek WebSocket API v1 s vysvětlením každé zprávy a výsledné změny v knize objednávek je následující:

1. Počáteční snímek

Zpráva počátečního snímku:

[0,{"as":[["5711.80000","8.13439401","1557070784.848047"],["5712.20000","2.00000000","1557070757.056750"],["5712.80000","0.30000000","1557070783.806432"],["5713.00000","3.29800000","1557070774.281619"],["5713.10000","1.00000000","1557070741.315583"],["5713.90000","1.00000000","1557070698.840502"],["5714.70000","0.50000000","1557070743.861074"],["5715.20000","1.00000000","1557070697.871150"],["5716.60000","1.22700000","1557070775.294557"],["5716.80000","0.35000000","1557070749.823148"]],"bs":[["5711.70000","0.00749800","1557070712.848376"],["5709.20000","3.30000000","1557070766.260894"],["5708.30000","0.75483907","1557070781.425374"],["5708.20000","5.00000000","1557070780.762871"],["5707.80000","2.50000000","1557070722.912548"],["5707.40000","4.33000000","1557070732.546143"],["5707.00000","0.00200000","1557070604.962840"],["5706.90000","1.17300000","1557070715.529722"],["5706.40000","0.85600000","1557070777.204262"],["5706.30000","1.00000000","1557070753.118938"]]},"book-10","XBT/USD"]

poskytuje následující počáteční knihu objednávek:

Screenshot_2021-06-08_at_07.52.08.png

2. Zpráva o aktualizaci/smazání/vložení

První zpráva o aktualizaci upravuje stranu nabídky knihy objednávek aktualizací stávající cenové úrovně 5709.2, smazáním stávající cenové úrovně 5708.2 a vložením (zahrnutím do rozsahu) nové cenové úrovně 5705.9:

[0,{"b":[["5709.20000","3.00000000","1557070785.898642"],["5708.20000","0.00000000","1557070786.010118"],["5705.90000","7.62400000","1557070783.582385","r"]], "c":"2470128591"},"book-10","XBT/USD"]

což dává následující aktualizovanou knihu objednávek:

Screenshot_2021-06-08_at_07.54.06.png


3. Zpráva o aktualizaci/vložení

Další zpráva o aktualizaci upravuje stranu nabídky knihy objednávek aktualizací stávající cenové úrovně 5709.2 a vložením nové cenové úrovně 5709.4 (což má vedlejší účinek posunutí všech následujících cenových úrovní o jednu úroveň ven a vytlačení cenové úrovně 5705.9 zpět mimo rozsah):

[0,{"b":[["5709.20000","8.00000000","1557070786.250425"],["5709.40000","0.30000000","1557070786.259115"]], "c":"4148072505"},"book-10","XBT/USD"]

což způsobuje následující aktualizovanou knihu objednávek:

Screenshot_2021-06-08_at_07.55.20.png



4. Zpráva o smazání/vložení

Další zpráva o aktualizaci mění stranu nabídky knihy objednávek smazáním cenové úrovně 5708.3 a vložením (zahrnutím zpět do rozsahu) cenové úrovně 5705.9:

[0,{"b":[["5708.30000","0.00000000","1557070786.389495"],["5705.90000","7.62400000","1557070783.582385","r"]], "c":"3093569863"},"book-10","XBT/USD"]

což dává následující aktualizovanou knihu objednávek:

Screenshot_2021-06-08_at_07.56.51.png



a tak dále ad infinitum, dokud není kanál knihy objednávek odhlášen nebo dokud není ukončeno připojení WebSocket.

Příklad kódu (v Pythonu), který implementuje klienta knihy objednávek z příkazového řádku a ilustruje logiku udržování platné knihy objednávek, je k dispozici ke kontrole a stažení:

Desetinné a tisícové oddělovače zobrazené v tomto článku se mohou lišit od formátů zobrazených na našich trading platforms. Přečtěte si náš článek o tom, jak používáme tečky a čárky pro více informací.

Potřebujete další pomoc?