WebSocket API v1 - Geçerli bir emir defteri nasıl sürdürülür

Emir defteri akışına abone olduktan sonra, ilk piyasa verisi mesajı mevcut emir defterinin bir anlık görüntüsü olacaktır.

Emir defteri anlık görüntüsü, istenen (abone olunan) derinliğe kadar tüm emir defterini içerir; örneğin, XBT/USD emir defterinin 10 derinliğe kadar olan aşağıdaki örneği:

[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"]

Anlık görüntü, mevcut en iyi alış/satış fiyatlarını, mevcut hacimlerini ve fiyat seviyesinin en son güncellendiği tarih/saati (6 ondalık basamağa kadar saniye cinsinden bir UNIX zaman damgası olarak) içerir.

Fiyat Seviyesi Değişiklikleri

İlk anlık görüntüden sonra, emir defterinin fiyat seviyeleri güncelleme, ekleme ve silme mesajları aracılığıyla gerçek zamanlı olarak değiştirilir.

Güncelleme Mesajları

Bir güncelleme mesajı, emir defterinde zaten mevcut olan bir fiyat seviyesini yeni bir hacim ve zaman damgası sağlayarak günceller; örneğin, emir defterinin satış tarafındaki 5293.1 fiyat seviyesi için aşağıdaki güncelleme:

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

Fiyat aynı kalırken (5293.1), o fiyattaki mevcut hacim 0.69800000'den (ilk anlık görüntüde sağlandığı gibi) 0.39800000'e değiştirilir ve fiyat seviyesi için yeni zaman damgası değişikliğin meydana geldiği tarih/saati yansıtır.

Güncelleme mesajları yalnızca emir defterinde zaten mevcut olan fiyat seviyelerini değiştirir; emir defterine fiyat seviyeleri eklemez veya çıkarmazlar.

Ekleme Mesajları

Bir ekleme mesajı, emir defterine yeni bir fiyat seviyesi ekler; örneğin, emir defterinin satış tarafındaki 5294.4 fiyat seviyesi için aşağıdaki ekleme:

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

Her ekleme mesajı, yeni fiyat seviyesini (5294.4), o fiyattaki mevcut hacmi (0.99600000) ve fiyat seviyesinin en son güncellendiği zaman damgasını içerir.

Ekleme mesajları, yeni bir fiyat seviyesi oluşturarak, sonraki tüm fiyat seviyelerini (daha düşük alış fiyatları veya daha yüksek satış fiyatları) dışa doğru hareket ettirerek ve en dıştaki fiyat seviyesini emir defterinin kapsamı dışına iterek emir defterindeki fiyat seviyelerini değiştirir.

Örneğin, yukarıdaki ilk anlık görüntüden, ekleme mesajı:

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

Emir defterine 10. seviyeye (en yüksek satış fiyatı) 5294.4 fiyat seviyesini ekler ve 5294.5 fiyat seviyesini emir defterinin kapsamı dışına taşır (5294.5'i etkili bir şekilde 11. seviyeye taşıyarak).

Silme Mesajları

Bir silme mesajı, emir defterinden bir fiyat seviyesini kaldırır; örneğin, emir defterinin satış tarafındaki 5294.1 fiyat seviyesi için aşağıdaki kısmi silme mesajı:

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

Silme mesajları, artık mevcut olmayan fiyat seviyesini içerir, her zaman 0.0'lık bir mevcut hacim belirtir ve fiyat seviyesinin emir defterinden kaldırıldığı tarih/saati gösteren bir zaman damgası içerir.

Silme mesajları, etkilenen fiyat seviyesini kaldırarak (yalnızca abone olunan derinlikten değil, emir defterinden tamamen), sonraki tüm fiyat seviyelerini (daha düşük alış fiyatları veya daha yüksek satış fiyatları) içeri doğru hareket ettirerek ve yeni bir fiyat seviyesini emir defterinin kapsamına çekerek emir defterindeki fiyat seviyelerini değiştirir.

Bir silme işleminin her zaman, en dıştaki seviyede (10 derinliğe abone olunan bir seviye için 10. seviye gibi) yeni bir fiyat seviyesini kapsama alanına getiren bir ekleme ile hemen takip edildiğini unutmayın.

Örneğin, yukarıdaki ilk anlık görüntüden, silme/ekleme mesajı:

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

Bu, emir defterinin 9. seviyesinden 5294.1 fiyat seviyesini siler, 5294.5 fiyat seviyesini 10. seviyeden 9. seviyeye taşır ve yeni 5294.7 fiyat seviyesini hemen emir defterinin 10. seviyesine (en dıştaki seviye ve 10 derinlik için en yüksek satış fiyatı) ekler.

Ek Kaynaklar

Emir defteri mantığının daha fazla detayı, örnek bir emir defteri dökümü ve eşzamansız (çok iş parçacıklı) ve eşzamanlı (tek iş parçacıklı) komut satırı istemcilerini uygulayan örnek kod aracılığıyla mevcuttur.

Bu makalede gösterilen ondalık ve binlik ayırıcılar, işlem platformlarımızda görüntülenen formatlardan farklılık gösterebilir. Noktaları ve virgülleri nasıl kullandığımız hakkında daha fazla bilgi için makalemizi inceleyin.