WebSocket API v1 - एक वैध ऑर्डर बुक कैसे बनाए रखें

ऑर्डर बुक फ़ीड की सदस्यता लेने के बाद, पहला बाज़ार डेटा संदेश वर्तमान ऑर्डर बुक का एक स्नैपशॉट होगा।

ऑर्डर बुक स्नैपशॉट में अनुरोधित (सदस्यता ली गई) गहराई तक की पूरी ऑर्डर बुक शामिल होती है, जैसे कि XBT/USD ऑर्डर बुक का 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"]

स्नैपशॉट में वर्तमान सर्वोत्तम बिड/आस्क कीमतें, उनकी उपलब्ध मात्राएँ, और वह दिनांक/समय शामिल है जब मूल्य स्तर को सबसे हाल ही में अपडेट किया गया था (6 दशमलव स्थानों तक सेकंड में एक UNIX टाइमस्टैम्प के रूप में)।

मूल्य स्तर में परिवर्तन

प्रारंभिक स्नैपशॉट के बाद, ऑर्डर बुक के मूल्य स्तरों को अपडेट, इंसर्ट और डिलीट संदेशों के माध्यम से वास्तविक समय में संशोधित किया जाता है।

अपडेट संदेश

एक अपडेट संदेश ऑर्डर बुक के भीतर पहले से मौजूद मूल्य स्तर को एक नई मात्रा और टाइमस्टैम्प प्रदान करके अपडेट करता है, जैसे कि ऑर्डर बुक के आस्क साइड पर मूल्य स्तर 5293.1 के लिए निम्नलिखित अपडेट:

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

जबकि कीमत वही रहती है (5293.1), उस कीमत पर उपलब्ध मात्रा 0.69800000 (प्रारंभिक स्नैपशॉट द्वारा प्रदान की गई) से बदलकर 0.39800000 हो जाती है, और मूल्य स्तर के लिए नया टाइमस्टैम्प उस दिनांक/समय को दर्शाता है जब परिवर्तन हुआ था।

अपडेट संदेश केवल उन मूल्य स्तरों को बदलते हैं जो ऑर्डर बुक के भीतर पहले से मौजूद हैं; वे ऑर्डर बुक में मूल्य स्तरों को जोड़ते या हटाते नहीं हैं।

इंसर्ट संदेश

एक इंसर्ट संदेश ऑर्डर बुक में एक नया मूल्य स्तर जोड़ता है, जैसे कि ऑर्डर बुक के आस्क साइड पर मूल्य स्तर 5294.4 के लिए निम्नलिखित इंसर्ट:

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

प्रत्येक इंसर्ट संदेश में नया मूल्य स्तर (5294.4), उस कीमत पर उपलब्ध मात्रा (0.99600000), और टाइमस्टैम्प शामिल होता है जब मूल्य स्तर को सबसे हाल ही में अपडेट किया गया था।

इंसर्ट संदेश ऑर्डर बुक के भीतर मूल्य स्तरों को एक नया मूल्य स्तर बनाकर, सभी बाद के मूल्य स्तरों (कम बिड कीमतें या उच्च आस्क कीमतें) को बाहर की ओर ले जाकर, और सबसे बाहरी मूल्य स्तर को ऑर्डर बुक के दायरे से बाहर धकेल कर बदलते हैं।

उदाहरण के लिए, ऊपर दिए गए प्रारंभिक स्नैपशॉट से, इंसर्ट संदेश:

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

ऑर्डर बुक में स्तर 10 (उच्चतम आस्क कीमत) पर मूल्य स्तर 5294.4 जोड़ देगा, और मूल्य स्तर 5294.5 को ऑर्डर बुक के दायरे से बाहर कर देगा (प्रभावी रूप से 5294.5 को स्तर 11 पर ले जाकर)।

डिलीट संदेश

एक डिलीट संदेश ऑर्डर बुक से एक मूल्य स्तर को हटाता है, जैसे कि ऑर्डर बुक के आस्क साइड पर मूल्य स्तर 5294.1 के लिए निम्नलिखित आंशिक डिलीट संदेश:

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

डिलीट संदेशों में वह मूल्य स्तर शामिल होता है जो अब मौजूद नहीं है, हमेशा 0.0 की उपलब्ध मात्रा निर्दिष्ट करता है, और एक टाइमस्टैम्प शामिल होता है जो उस दिनांक/समय को इंगित करता है जब मूल्य स्तर को ऑर्डर बुक से हटाया गया था।

डिलीट संदेश ऑर्डर बुक के भीतर मूल्य स्तरों को प्रभावित मूल्य स्तर को हटाकर (पूरी तरह से ऑर्डर बुक से, न कि केवल सदस्यता ली गई गहराई से), सभी बाद के मूल्य स्तरों (कम बिड कीमतें या उच्च आस्क कीमतें) को अंदर की ओर ले जाकर, और एक नए मूल्य स्तर को ऑर्डर बुक के दायरे में खींचकर बदलते हैं।

ध्यान दें कि एक डिलीट के तुरंत बाद हमेशा एक इंसर्ट होता है जो सबसे बाहरी स्तर पर (जैसे 10 की सदस्यता ली गई गहराई के लिए स्तर 10) एक नया मूल्य स्तर दायरे में लाता है।

उदाहरण के लिए, ऊपर दिए गए प्रारंभिक स्नैपशॉट से, डिलीट/इंसर्ट संदेश:

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

यह ऑर्डर बुक के स्तर 9 से मूल्य स्तर 5294.1 को हटा देगा, मूल्य स्तर 5294.5 को स्तर 10 से स्तर 9 पर ले जाएगा, और तुरंत नए मूल्य स्तर 5294.7 को ऑर्डर बुक के स्तर 10 पर जोड़ देगा (सबसे बाहरी स्तर और 10 की गहराई के लिए उच्चतम आस्क कीमत)।

अतिरिक्त संसाधन

ऑर्डर बुक लॉजिक का विस्तृत विवरण नमूना ऑर्डर बुक ट्रांसक्रिप्ट और एसिंक्रोनस (मल्टी-थ्रेडेड) और सिंक्रोनस (सिंगल-थ्रेडेड) कमांड लाइन क्लाइंट को लागू करने वाले उदाहरण कोड के माध्यम से उपलब्ध है।

इस लेख में दिखाए गए दशमलव और हज़ार विभाजक हमारे ट्रेडिंग प्लेटफ़ॉर्म पर प्रदर्शित प्रारूपों से भिन्न हो सकते हैं। हम बिंदुओं और अल्पविरामों का उपयोग कैसे करते हैं, इस बारे में अधिक जानकारी के लिए हमारा लेख देखें।