API कुंजियाँ API प्रमाणीकरण के प्राथमिक घटकों में से एक हैं; वे आपके Kraken खाते के उपयोगकर्ता नाम और पासवर्ड के API समतुल्य हैं।
खाते-विशिष्ट (उर्फ निजी) API एंडपॉइंट्स को कॉल करने के लिए API कुंजियों की आवश्यकता होती है, जैसे कि खाता प्रबंधन, ट्रेडिंग, फंडिंग, और अर्जित करें एंडपॉइंट्स। बाजार डेटा (उर्फ सार्वजनिक) API एंडपॉइंट्स को कॉल करने के लिए API कुंजियों की आवश्यकता नहीं होती है, क्योंकि बाजार डेटा एंडपॉइंट्स किसी विशिष्ट Kraken खाते से संबद्ध नहीं होते हैं।
API कुंजियों का उपयोग किसी भी सॉफ़्टवेयर द्वारा किया जा सकता है जो हमारे बाजारों और खातों के साथ इंटरैक्ट करता है, जैसे कि हमारे REST API कमांड लाइन क्लाइंट, कुछ मोबाइल ऐप, तृतीय-पक्ष ट्रेडिंग बॉट, और कई अन्य उत्पाद/सेवाएँ।
खाता मेनू खोलें (पृष्ठ के ऊपरी-दाएँ कोने में मानव आइकन पर क्लिक करें)
सेटिंग्स विकल्प चुनें
API टैब पर जाएँ, फिर "API कुंजी बनाएँ" पर क्लिक करें (आप अगले चरणों में अपनी API कुंजी को कॉन्फ़िगर कर पाएंगे)
API कुंजियों में कई सेटिंग्स और विकल्प होते हैं जिन्हें API कुंजी का उपयोग करने से पहले कॉन्फ़िगर किया जाना चाहिए, विशेष रूप से नाम/विवरण और एक्सेस अनुमतियाँ।
कुंजी का नाम अनिवार्य रूप से API कुंजी का नाम है, और यह आपकी पसंद का लगभग कुछ भी हो सकता है, जब तक कि विवरण अद्वितीय हो (उसी खाते पर किसी अन्य API कुंजी के विवरण से भिन्न)।
संवेदनशील जानकारी को उजागर किए बिना अपनी API कुंजी को एक वर्णनात्मक नाम देना सबसे अच्छा अभ्यास है। (जैसे "ट्रेडिंग कुंजी", "खाता प्रबंधन कुंजी", "पायथन API कुंजी 6", या "मोबाइल ऐप कुंजी", उदाहरण के लिए)।
कुंजी अनुमतियाँ निर्धारित करती हैं कि API कुंजी को किन खाता-विशिष्ट (निजी) API एंडपॉइंट्स को कॉल करने की अनुमति है:
फंड क्वेरी करें उन API एंडपॉइंट्स के लिए आवश्यक है जो खाता शेष जानकारी क्वेरी करते हैं, जैसे बैलेंस और ट्रेडबैलेंस।
फंड जमा करें जमा से संबंधित फंडिंग एंडपॉइंट्स के लिए आवश्यक है, जैसे डिपॉजिट मेथड्स और डिपॉजिट एड्रेस।
फंड निकालें निकासी से संबंधित फंडिंग एंडपॉइंट्स के लिए आवश्यक है, जैसे विथड्रॉ इन्फो, विथड्रॉ और विथड्रॉ कैंसिल।
खुले ऑर्डर और ट्रेड क्वेरी करें उन API एंडपॉइंट्स के लिए आवश्यक है जो पहले से मौजूद ऑर्डर और मार्जिन पोजीशन क्वेरी करते हैं, जैसे ओपनऑर्डर्स, क्वेरीऑर्डर्स और ओपनपोज़िशन्स।
बंद किए गए ऑर्डर और ट्रेडों को क्वेरी करें उन एंडपॉइंट्स के लिए आवश्यक है जो पहले से बंद/रद्द किए गए ऑर्डर और मार्जिन पोजीशन को क्वेरी करते हैं, जैसे कि ClosedOrders, QueryOrders और QueryTrades।
ऑर्डर संशोधित करें उन ट्रेडिंग एंडपॉइंट्स के लिए आवश्यक है जो नए ऑर्डर देते हैं, जैसे कि AddOrder, EditOrder और AddOrderBatch।
ऑर्डर रद्द/बंद करें उन ट्रेडिंग एंडपॉइंट्स के लिए आवश्यक है जो खुले या लंबित ऑर्डर रद्द करते हैं, जैसे कि CancelOrder, CancelAll और CancelOrderBatch।
लेजर प्रविष्टियों को क्वेरी करें उन API एंडपॉइंट्स के लिए आवश्यक है जो अकाउंट लेजर से ऐतिहासिक अकाउंट डेटा प्राप्त करते हैं, अर्थात् Ledgers और QueryLedgers।
डेटा निर्यात करें उन एंडपॉइंट्स के लिए आवश्यक है जो अकाउंट लेजर को निर्यात (डाउनलोड) करते हैं, अर्थात् AddExport, RetrieveExport, ExportStatus और RemoveExport।
API कुंजी अनुमतियों का सही ढंग से उपयोग करने के उदाहरण के रूप में, एक API कुंजी पर विचार करें जो ट्रेडिंग उद्देश्यों के लिए किसी तीसरे पक्ष को प्रदान की जाती है। ऐसी API कुंजी को निश्चित रूप से ऑर्डर संशोधित करें और ऑर्डर रद्द/बंद करें अनुमतियों की आवश्यकता होगी, संभवतः खुले ऑर्डर और ट्रेडों को क्वेरी करें अनुमति की आवश्यकता होगी, लेकिन लगभग निश्चित रूप से फंड निकालें अनुमति की आवश्यकता नहीं होगी।
अनुमतियों को उचित रूप से कॉन्फ़िगर करने से API क्लाइंट को खाते के लिए ट्रेड करने की अनुमति मिलेगी, लेकिन API क्लाइंट को किसी भी खाते की जानकारी तक पहुंचने या फंडिंग कार्य करने से रोका जा सकेगा।
शेष API कुंजी सेटिंग्स केवल अधिक उन्नत कॉन्फ़िगरेशन के लिए आवश्यक हैं, इसलिए उन्हें आमतौर पर उनके डिफ़ॉल्ट मानों पर रखा जा सकता है:
WebSocket APIs के लिए प्रमाणीकरण टोकन को GetWebSocketsToken एंडपॉइंट के माध्यम से प्राप्त करने के लिए वेब सॉकेट इंटरफ़ेस आवश्यक है।
IP एड्रेस प्रतिबंध एक सुरक्षा सुविधा है जो API कुंजी के उपयोग को विशिष्ट क्लाइंट-साइड IP एड्रेस तक सीमित करती है।
कुंजी की समय-सीमा का उपयोग एक API कुंजी बनाने के लिए किया जा सकता है जो केवल एक विशिष्ट समय अवधि के लिए काम करती है, जैसे कि एक कुंजी जो केवल 1 सप्ताह के लिए वैध है।
क्वेरी प्रारंभ/समाप्ति तिथि/समय एक सेटिंग है जो ऐतिहासिक खाता डेटा अनुरोधों को एक विशिष्ट समय-सीमा तक सीमित करती है, जैसे कि एक कुंजी जो इस वर्ष से ट्रेडिंग इतिहास प्राप्त कर सकती है, लेकिन पिछले किसी भी वर्ष से नहीं।
कस्टम नॉनस विंडो एक सेटिंग है जिसका उपयोग नेटवर्किंग समस्याओं को दूर करने के लिए किया जाता है जो API अनुरोधों को क्रम से बाहर आने का कारण बन सकती हैं, एक छोटी समय-सीमा (1 सेकंड, 10 सेकंड, आदि) प्रदान करके जिसके दौरान एक अमान्य नॉनस (पहले उपयोग किए गए नॉनस मान से कम नॉनस मान) वाले API अनुरोध अमान्य नॉनस त्रुटि का कारण नहीं बनेंगे।
एक बार जब API कुंजी सेटिंग्स को उचित रूप से कॉन्फ़िगर कर लिया जाता है, तो कुंजी जनरेट करें बटन पर क्लिक करके नई API कुंजी बनाई जा सकती है।
API कुंजी, निजी कुंजी और QR कोड को आपके उपयोगकर्ता नाम/पासवर्ड के समान ही माना जाना चाहिए। यदि आपको बाद में उन्हें फिर से एक्सेस करने की आवश्यकता हो तो कृपया उन्हें पासवर्ड मैनेजर में सहेजें। उन्हें एक अनएन्क्रिप्टेड प्रारूप में सहेजें नहीं!
API कुंजियों में एक सार्वजनिक और निजी कुंजी जोड़ी होती है, जिनमें से दोनों को API क्लाइंट सॉफ़्टवेयर को प्रदान किया जाना चाहिए।
API कुंजियाँ विभिन्न तरीकों से प्रदान की जा सकती हैं, उदाहरण के लिए:
कुंजी जोड़े को सीधे API क्लाइंट कोड में सादे पाठ के रूप में कॉपी और पेस्ट किया जा सकता है। उदाहरण: हमारे PHP API क्लाइंट द्वारा उपयोग की जाने वाली विधि।
कुंजी जोड़े को सादे पाठ फ़ाइलों में कॉपी और पेस्ट किया जा सकता है जिन्हें API क्लाइंट एक्सेस कर सकता है। उदाहरण: हमारे कमांड लाइन API क्लाइंट द्वारा उपयोग की जाने वाली विधि।
ध्यान दें: निजी कुंजी को कुछ API क्लाइंट सॉफ़्टवेयर द्वारा API सीक्रेट (या केवल सीक्रेट) के रूप में भी जाना जाता है।
API कुंजियाँ पहले से ही Kraken खाते तक API पहुँच को प्रमाणित करने का एक सुरक्षित तरीका प्रदान करती हैं, लेकिन दो-कारक प्रमाणीकरण (2FA) जोड़कर उनकी सुरक्षा को और भी बढ़ाया जा सकता है।
API कुंजी 2FA को सुरक्षा पृष्ठ के माध्यम से पहले से मौजूद API कुंजी में जोड़ा जा सकता है और यह या तो एक स्थिर पासवर्ड या Google Authenticator का उपयोग कर सकता है।
ध्यान दें: API कुंजी में 2FA जोड़ने के लिए यह भी आवश्यक है कि API क्लाइंट 2FA का समर्थन करता हो (निजी API विधियों के प्रत्येक कॉल के लिए 2FA डेटा प्रदान करता हो), अन्यथा वांछित API आउटपुट के बजाय एक अप्रत्याशित त्रुटि वापस आ जाएगी।
API कुंजियों के लिए 2FA कैसे काम करता है, इसके बारे में अधिक जानकारी यहां पढ़ें।