Kraken WebSocket API - अक्सर पूछे जाने वाले प्रश्न

क्या Kraken के पास WebSocket API है? मैं इससे कैसे कनेक्ट कर सकता हूँ?

Kraken के पास REST API और WebSocket API दोनों हैं। हमारा WebSocket API निम्नलिखित सुरक्षित URL पर उपलब्ध है:

सार्वजनिक (अप्रमाणित) बाज़ार डेटा फ़ीड: wss://ws.kraken.com/

निजी (प्रमाणित) खाता डेटा फ़ीड और ट्रेडिंग एंडपॉइंट: wss://ws-auth.kraken.com/

सार्वजनिक बाज़ार डेटा फ़ीड से कनेक्ट करने के लिए प्रमाणीकरण की आवश्यकता नहीं है, लेकिन निजी फ़ीड के लिए एक वैध प्रमाणीकरण टोकन आवश्यक है।

WebSocket API के माध्यम से भेजे और प्राप्त किए गए सभी संदेश JSON प्रारूप में सादे पाठ में एन्कोड किए जाते हैं। प्रत्येक संदेश प्रकार का विवरण हमारे WebSocket API दस्तावेज़ में प्रदान किया गया है।

क्या आपके पास WebSocket लाइब्रेरी उपलब्ध हैं?

हमारे पास विभिन्न प्रकार के WebSocket API उदाहरण कोड उपलब्ध हैं, जिनका उपयोग सीधे किया जा सकता है, या आपके अपने कार्यान्वयन के लिए शुरुआती बिंदु के रूप में किया जा सकता है:

हमारा WebSocket API आपकी पसंद की किसी भी प्रोग्रामिंग भाषा में लागू किया जा सकता है, और हमारी API सहायता टीम आपको सहायता करने या अतिरिक्त भाषाओं में उदाहरण कोड प्रदान करने में प्रसन्न होगी, यदि आवश्यक हो।

कौन से फ़ीड/एंडपॉइंट समर्थित हैं?

हमारा WebSocket API विभिन्न प्रकार के वास्तविक समय बाज़ार डेटा फ़ीड, खाता डेटा फ़ीड और ट्रेडिंग एंडपॉइंट प्रदान करता है। उपलब्ध फ़ीड/एंडपॉइंट की एक पूरी सूची, प्रत्येक फ़ीड/एंडपॉइंट के लिए कार्यान्वयन विवरण के साथ, हमारे WebSocket API दस्तावेज़ में पाई जा सकती है।

मुझे कैसे पता चलेगा कि मैं सफलतापूर्वक कनेक्ट हो गया हूँ? मुझे कैसे पता चलेगा कि मैं अभी भी कनेक्टेड हूँ?

जब किसी फ़ीड की सदस्यता ली जाती है, तो {u'event': u'heartbeat'} संदेश प्रति सेकंड 1 हार्टबीट की आवृत्ति पर प्राप्त होगा।

यदि अन्य संदेश (बाज़ार डेटा, खाता डेटा, आदि) प्राप्त होते हैं, तो हार्टबीट प्राप्त नहीं होंगे। बाज़ार या खाता डेटा कब और क्यों प्राप्त होता है, यह उस फ़ीड पर निर्भर करता है जिसकी आपने सदस्यता ली है।

यदि आप कम ट्रेडिंग वॉल्यूम वाले करेंसी पेयर के फ़ीड की सदस्यता ले रहे हैं, तो आपको लंबे समय तक केवल हार्टबीट ही प्राप्त हो सकते हैं।

यदि आप किसी फ़ीड की सदस्यता रद्द करते हैं, तो आपको हार्टबीट या ट्रेडिंग डेटा प्राप्त नहीं होगा और 1 मिनट तक किसी भी फ़ीड की सदस्यता न लेने के बाद आप WebSockets फ़ीड से डिस्कनेक्ट हो जाएंगे।

WebSocket अद्यतन डेटा कब और क्यों भेजता है?

बाज़ार डेटा या खाता डेटा कब और क्यों प्राप्त होता है, यह उस फ़ीड पर निर्भर करता है जिसकी आपने सदस्यता ली है। उदाहरण के लिए:

टिकर: जब किसी करेंसी पेयर के लिए कोई ट्रेड या ट्रेड का बैच होता है, तो उस पेयर के लिए एक टिकर संदेश प्रकाशित किया जाता है। आपको यह संदेश तभी प्राप्त होगा जब आपने इस पेयर के लिए टिकर फ़ीड की सदस्यता ली हो।

ट्रेड: इसी तरह, जब किसी करेंसी पेयर के लिए कोई ट्रेड या ट्रेड का बैच होता है, तो उस पेयर के लिए एक ट्रेड संदेश भी प्रकाशित किया जाता है। आपको यह संदेश तभी प्राप्त होगा जब आपने इस पेयर के लिए ट्रेड फ़ीड की सदस्यता ली हो।

OHLC: प्रत्येक अंतराल के लिए एक अद्यतन OHLC अंतराल प्रकाशित किया जाता है जब किसी करेंसी पेयर के लिए कोई ट्रेड या ट्रेड का बैच निष्पादित किया जाता है। आपको केवल उन अंतरालों के लिए अपडेट प्राप्त होंगे जिनकी आपने सदस्यता ली है। एक अंतराल सीमा पार करने के बाद, अगला ट्रेड होने तक कोई संदेश नहीं भेजा जाता है।

बुक: ऑर्डर बुक का एक प्रारंभिक स्नैपशॉट चुने हुए गहराई के साथ तब प्रकाशित किया जाता है जब पहली बार बुक फ़ीड की सदस्यता ली जाती है।

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

स्प्रेड: जब एक नया उच्चतम बिड या निम्नतम आस्क ऑर्डर दिया जाता है, या कोई ट्रेड निष्पादित होता है जो सर्वोत्तम बिड या सर्वोत्तम आस्क मूल्य को बदलता है, तो अद्यतन बिड और आस्क मूल्यों के साथ एक स्प्रेड संदेश प्रकाशित किया जाता है।

क्या WebSocket फ़ीड ऐतिहासिक डेटा प्रदान करते हैं या केवल वर्तमान डेटा?

WebSocket बाज़ार डेटा फ़ीड केवल वर्तमान डेटा प्रदान करते हैं, हालांकि वर्तमान डेटा के लिए WebSocket API और ऐतिहासिक डेटा के लिए REST API से एक साथ कनेक्ट करना संभव है।

reqid पैरामीटर का उपयोग।

सदस्यता अनुरोधों में क्लाइंट द्वारा प्रदान किया गया reqid पैरामीटर शामिल हो सकता है जिसका उपयोग बाद में वांछित WebSocket सदस्यता अनुरोध को उस सदस्यता के लिए चैनल ID से मिलान करने के लिए किया जा सकता है।

ध्यान दें कि यदि आप एक ही समय में कई WebSocket सदस्यताएँ बनाते हैं, तो उन सभी को एक ही reqid मान असाइन किया जाएगा। एक अलग reqid मान असाइन करने के लिए, प्रत्येक फ़ीड की व्यक्तिगत रूप से सदस्यता लेनी होगी।

मुझे और विवरण चाहिए, मैं उन्हें कहाँ पा सकता हूँ?

पूरी WebSocket API विशिष्टता WebSocket API दस्तावेज़ में उपलब्ध है।

REST और WebSocket API में करेंसी पेयर प्रतीकों के बीच अंतर।

WebSocket API केवल ISO 4217-A3 प्रारूप में करेंसी पेयर प्रतीकों को स्वीकार करता है, जैसे XBT/USD।

REST API AssetPairs एंडपॉइंट का उपयोग REST API संस्करणों (जैसे XBTUSD या XXBTZUSD) और WebSocket API संस्करण (जैसे XBT/USD) के बीच प्रतीकों का अनुवाद करने के लिए किया जा सकता है।

https://api.kraken.com/0/public/AssetPairs

wsname फ़ील्ड WebSocket API प्रतीक प्रदान करता है।

ऑर्डर बुक कैसे बनाएं

WebSocket API बुक फ़ीड सभी WebSocket फ़ीड में सबसे जटिल है, लेकिन जब तक बुक फ़ीड संदेशों की सही व्याख्या की जाती है, तब तक कुछ ही लाइनों के कोड के साथ ऑर्डर बुक की एक स्थानीय प्रतिलिपि बनाए रखना संभव है।

हमारे WebSocket API सहायता पृष्ठ बुक फ़ीड संदेशों की व्याख्या करने के लिए विस्तृत निर्देश, एक उदाहरण बुक फ़ीड प्रतिलेख, और उदाहरण कोड (पायथन में) प्रदान करते हैं ताकि ऑर्डर बुक की एक वैध स्थानीय प्रतिलिपि बनाए रखी जा सके।

WebSocket API कनेक्शन सीमाएँ क्या हैं?

WebSocket API दुरुपयोग (जैसे DDoS हमले, उदाहरण के लिए) से सुरक्षा प्रदान करने के लिए एक साथ कनेक्शन की अधिकतम संख्या को सीमित करता है। यदि आपका WebSocket क्लाइंट एक ही समय में बहुत अधिक कनेक्शन बनाता है, तो निम्नलिखित त्रुटि संदेश प्राप्त होगा:

{“error”: {“message”: “You have reached maximum capacity for WebSocket connections. Please reach out to Kraken support team for any questions.“, “hint”: “Your code may be reconnecting too often or when it has no need to.“, “name”: “WebSocket connection rate error”}}

WebSocket API एक ही WebSocket कनेक्शन के माध्यम से कई फ़ीड सदस्यताएँ (जैसे XBT/USD करेंसी पेयर के लिए सभी उपलब्ध बाज़ार डेटा की सदस्यता लेना) की अनुमति देता है, इसलिए WebSocket कनेक्शन सीमाओं तक पहुँचे बिना सभी करेंसी पेयर के लिए सभी उपलब्ध बाज़ार डेटा को स्ट्रीम करना संभव है।

WebSocket API दर सीमाएँ क्या हैं?

सभी ऑर्डर एंट्री इंटरफेस (वेबसाइट, Kraken टर्मिनल, REST और WebSocket API) पर समान ट्रेडिंग दर सीमाएँ लागू होती हैं, और हमारे दर सीमा सहायता पृष्ठ पर विस्तार से बताई गई हैं।

एकल WebSocket API कनेक्शन की संदेश दर सीमा सिस्टम पर लोड के आधार पर भिन्न होगी। WebSocket API क्लाइंट को त्रुटि संदेश {"Error": "Exceeded msg rate"} प्राप्त होगा जब संदेश दर सीमा पार हो जाएगी।

WebSocket API के माध्यम से ट्रेडिंग (ऑर्डर देना/रद्द करना)।

WebSocket API के माध्यम से ट्रेडिंग addOrder और cancelOrder एंडपॉइंट के माध्यम से उपलब्ध है, जिनका उपयोग क्रमशः नए ऑर्डर देने और मौजूदा (खुले) ऑर्डर रद्द करने के लिए किया जाता है।

WebSocket ट्रेडिंग एंडपॉइंट उसी निजी WebSocket कनेक्शन (wss://ws-auth.kraken.com/) के माध्यम से उपलब्ध हैं जैसे निजी खाता प्रबंधन फ़ीड (openOrders और ownTrades)।

ट्रेडिंग एंडपॉइंट के संबंध में पूर्ण विवरण WebSocket API दस्तावेज़ के माध्यम से उपलब्ध हैं, और हमारे WebSocket API सहायता पृष्ठ आपके अपने कोड में ट्रेडिंग एंडपॉइंट का उपयोग करने के लिए अतिरिक्त जानकारी और उदाहरण प्रदान करते हैं।

WebSocket API से कनेक्ट करते समय मुझे 403 त्रुटि क्यों प्राप्त होती है?

WebSocket API कनेक्शन Cloudflare के माध्यम से मध्यस्थता किए जाते हैं, इसलिए Cloudflare द्वारा लागू की गई कोई भी सुरक्षा सेटिंग्स सार्वजनिक (wss://ws.kraken.com) और निजी (wss://ws-auth.kraken.com) दोनों URL से कनेक्शन को प्रभावित कर सकती हैं।

Cloudflare को सभी TLS कनेक्शन के लिए सर्वर नेम इंडिकेशन (SNI) का उपयोग करने की आवश्यकता है, अन्यथा WebSocket कनेक्शन विफल हो जाएगा, और इसके बजाय एक HTTP 403 फॉरबिडन त्रुटि वापस कर दी जाएगी। Cloudflare के सहायता पृष्ठ उनके TLS SNI आवश्यकता के संबंध में अतिरिक्त विवरण प्रदान करते हैं।

हमारी आधिकारिक पायथन WebSocket API लाइब्रेरी को TLS SNI का समर्थन करने के लिए अद्यतन किया गया है, लेकिन कुछ तृतीय-पक्ष WebSocket API लाइब्रेरी अभी भी प्रभावित हो सकती हैं। यदि आपको TLS SNI का समर्थन करने के लिए अपने WebSocket API कोड को अद्यतन करने में किसी सहायता की आवश्यकता है, तो कृपया हमारी API सहायता टीम से संपर्क करें।

WebSocket API सहायता।

यदि आपको अपने WebSocket API क्लाइंट को लागू करने में किसी सहायता की आवश्यकता है, तो कृपया हमारी API सहायता टीम से संपर्क करें।