क्रिप्टो एक्सचेंज API रेट लिमिट्स

क्रिप्टो एक्सचेंज API रेट लिमिट्स की व्याख्या

1. “API रेट लिमिट्स” का मतलब क्या है

कागज़ पर API रेट लिमिट्स सीधी-सी बात हैं। ये बताते हैं कि एक एक्सचेंज किसी तय समय-सीमा, जैसे 1 सेकंड, 1 मिनट या 1 घंटे में, अधिकतम कितने अनुरोध स्वीकार करेगा। क्रिप्टो एक्सचेंज API रेट लिमिट्स की यही मूल बात है, और यह समझना कि API rate limit क्या होता है, इसी का पहला कदम है।

रेट लिमिट्स को फीस समझने की गलती न करें। फीस ट्रेड, विड्रॉल या किसी सर्विस टियर के लिए लिया गया पैसा होती है। रेट लिमिट ट्रैफिक का नियम है। अगर आपका क्लाइंट एक मिनट में 200 अनुरोध भेजता है और एक्सचेंज सिर्फ 120 की अनुमति देता है, तो 121वाँ अनुरोध फेल हो सकता है, भले ही आपका अकाउंट मुफ़्त हो।

लिमिट्स को अकाउंट टियर्स से भी अलग समझें। कुछ एक्सचेंज वेरिफ़ाइड यूज़र्स, मार्केट मेकर्स या पेड प्लान्स को ज़्यादा लिमिट देते हैं, लेकिन रेट लिमिट फिर भी मौजूद रहती है। एक टियर में प्रति सेकंड 10 अनुरोध मिल सकते हैं, जबकि दूसरे में 50। एक्सचेंज तब भी एक सीमा खींच रहा होता है।

इसे समझने का आसान तरीका यह है: रेट लिमिट्स API के लिए दरवाज़े की नीति हैं। अंदर आने की अनुमति हो सकती है, लेकिन सब एक साथ नहीं। व्यस्त दिनों में यही फर्क बहुत मायने रखता है।

2. एक्सचेंज रेट लिमिट्स क्यों लगाते हैं

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

न्याय का पहलू भी है। बिना लिमिट्स के, कोई आक्रामक बॉट पब्लिक एंडपॉइंट्स पर बार-बार अनुरोध करके छोटे यूज़र्स को पीछे धकेल सकता है। यह सिर्फ़ सिद्धांत नहीं है; नई लिस्टिंग या तेज़ बिकवाली के दौरान जब रिक्वेस्ट वॉल्यूम बढ़ जाता है, तब यह समस्या सामने आती है।

कुछ लिमिट्स स्क्रैपिंग, दुरुपयोग या गलती से बने लूप्स को रोकने के लिए होती हैं। एक खराब लूप किसी के ध्यान देने से पहले वही अनुरोध 500 बार भेज सकता है। एक्सचेंज को यह दुर्घटना नहीं, तूफ़ान जैसा दिखता है।

फिर भी, लिमिट्स सिर्फ़ बचाव के लिए नहीं होतीं। ये एक्सचेंज को बाज़ार डेटा ताज़ा रखने और ट्रैफिक बढ़ने पर ऑर्डर सिस्टम को तेज़ बनाए रखने में मदद करती हैं। एक स्थिर API उस API से कहीं बेहतर भरोसेमंद होती है जो अचानक दबाव में टूट जाए।

3. रेट लिमिट्स कैसे मापी जाती हैं

ज़्यादातर एक्सचेंज लिमिट्स को प्रति सेकंड या प्रति मिनट अनुरोधों के रूप में मापते हैं। कुछ एक मिश्रित सिस्टम इस्तेमाल करते हैं, जिसमें एक छोटा per-second cap और एक बड़ा per-minute cap होता है। एक्सचेंज अलग-अलग एंडपॉइंट्स को अलग वज़न भी दे सकता है। एक साधारण प्राइस चेक 1 यूनिट गिना जा सकता है, जबकि ऑर्डर प्लेसमेंट या हिस्ट्री क्वेरी ज़्यादा यूनिट्स गिन सकती है।

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

कुछ APIs बर्स्ट की अनुमति देती हैं। इसका मतलब है कि आप कुछ सेकंड के लिए स्थिर दर से ऊपर अनुरोधों का छोटा-सा समूह भेज सकते हैं, बशर्ते औसत नियम के भीतर रहे। दूसरी APIs सख़्त और सपाट होती हैं, जहाँ बर्स्ट की कोई गुंजाइश नहीं होती। यह अंतर तय करता है कि आप क्लाइंट कैसे लिखेंगे।

यूनिट, विंडो और वज़न देखें। यही तीन नंबर ज़्यादातर कहानी बता देते हैं। सिर्फ़ “rate limited” लिखा होना काफ़ी नहीं है।

4. असल कामकाज में लिमिट्स कहाँ दिखती हैं

लिमिट्स सबसे पहले साधारण कामों में दिखती हैं। कोई ट्रेडर अगर हर 2 सेकंड में प्राइस रिफ्रेश करता है, तो 20 मार्केट एक साथ चेक करने पर वह जल्दी सीमा छू सकता है। कोई डेवलपर हर 5 सेकंड में बैलेंस सिंक कर रहा हो, तो शुरुआत में सब ठीक लगेगा; लेकिन जैसे ही वॉलेट लिस्ट 3 एसेट्स से बढ़कर 30 हो जाएगी, अचानक फ़ेल्यर्स दिखने लगेंगे।

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

ऐतिहासिक बैकफ़िल्स का कम आँकना और भी आसान है। 90 दिनों के कैंडल्स, ट्रेड हिस्ट्री या फ़िल्स खींचना अक्सर हज़ारों अनुरोधों का मतलब होता है, और अगर एक्सचेंज बैच एंडपॉइंट न दे तो हर अनुरोध लाइव ट्रैफिक से प्रतिस्पर्धा करता है। अगर API हर कॉल में सिर्फ़ 100 पंक्तियाँ लौटाती है, तो गणित जल्दी मुश्किल हो जाता है।

पोलींग समय पर लगने वाला छिपा हुआ टैक्स है, पैसों पर नहीं। एक डैशबोर्ड जो हर सेकंड पाँच एंडपॉइंट्स चेक करता है, टेस्टिंग में नुकसानदेह नहीं लगता; लेकिन जैसे ही असली यूज़र्स लॉग इन करते हैं, वह रेट लिमिट को ओवरलोड कर सकता है। इसी वजह से कई टीमें पहले मुश्किल महीने के बाद पोलींग से वेब्सॉकेट्स पर चली जाती हैं।

5. आम चेतावनी संकेत और फ़ेल्योर मोड

सबसे साफ़ संकेत एक HTTP त्रुटि है, अक्सर बहुत ज़्यादा अनुरोधों के लिए 429 स्टेटस। यही वजह है कि क्रिप्टो API 429 error को समय रहते पहचानना और संभालना ज़रूरी है। कुछ एक्सचेंज साफ़ संदेश देते हैं। दूसरे एक सामान्य-सा फेल्योर देते हैं और उम्मीद करते हैं कि क्लाइंट हेडर्स पढ़ ले। मज़ेदार नहीं, लेकिन आम बात है।

अस्थायी थ्रॉटलिंग भी एक नतीजा हो सकता है। API कॉल्स को पूरी तरह अस्वीकार करने से पहले रिस्पॉन्स धीमा कर सकती है। आप अनुरोध भेजते हैं, और फिर 120 मिलीसेकंड की जगह 1.5 सेकंड इंतज़ार करते हैं। यही देरी बंद होने से पहले की चेतावनी है।

कुछ प्लेटफ़ॉर्म बार-बार उल्लंघन के बाद बैन विंडो लगा देते हैं। यह 30 सेकंड, 5 मिनट या उससे ज़्यादा भी हो सकती है। गंभीर मामलों में एक्सचेंज IP एड्रेस या API key को ब्लॉक कर सकता है। अगर कोई बॉट बिना सोचे-समझे बार-बार retry करता रहे, तो सज़ा और बढ़ जाती है।

बिना किसी साफ़ rate-limit संदेश के ऑर्डर रिजेक्शन भी हो सकते हैं। कोई ट्रेड अनुरोध इसलिए फेल हो सकता है क्योंकि क्लाइंट पहले ही allowed burst quota खपा चुका है, जबकि वही अकाउंट अब भी पब्लिक डेटा ला सकता है। पहली इंटीग्रेशन के दौरान यह असमानता कई टीमों को उलझा देती है।

6. एक्सचेंज के रेट-लिमिट नियम कैसे पढ़ें

डॉक्यूमेंटेशन से शुरुआत करें, लेकिन पहली तालिका देखकर रुकें नहीं। एंडपॉइंट वेट्स, कूलडाउन नियम, और अपवादों से जुड़े नोट्स देखें। किसी पेज पर “10 requests per second” लिखा हो सकता है, लेकिन चुपचाप यह भी जोड़ दिया जाता है कि ऑर्डर एंडपॉइंट्स का वज़न 5 है। इससे वास्तविक क्षमता काफी बदल जाती है।

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

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

टीमें इंटीग्रेशन से पहले अक्सर एक आसान चेकलिस्ट रखती हैं। अगर आप एक व्यापक प्री-लॉन्च चेकलिस्ट चाहते हैं, तो क्रिप्टो एक्सचेंज सुरक्षा चेकलिस्ट वाला लेख उपयोगी साथी है, क्योंकि रेट-लिमिट की गलतियाँ और सुरक्षा की गलतियाँ अक्सर साथ-साथ सामने आती हैं, खासकर जब API key उजागर हो जाए या उसका गलत इस्तेमाल हो।

डॉक्यूमेंटेशन की भाषा पर भी ध्यान दें। छोटी-सी शब्दावली असली सीमाएँ छिपा सकती है। अगर पेज “fair use” कहता है, तो संख्या पूछें। अगर वह “subject to change” कहता है, तो पूछें कि इसे कौन और कितनी बार बदलता है। जवाब प्रोडक्शन से पहले ज़रूरी है, आउटेज के बाद नहीं।

7. रेट-लिमिट से जुड़े उपयोगी शब्द

Throttle का मतलब है कि एक्सचेंज जानबूझकर आपकी गति कम कर रहा है। यह अभी पूरी तरह फेल्योर नहीं है, लेकिन उसके क़रीब है। आपको रिस्पॉन्स मिल सकते हैं, बस सामान्य से देर से।

Quota किसी अवधि के लिए कुल अनुमति है। अगर quota 100 requests per minute है, तो वह संख्या मिनट वाली विंडो खत्म होने पर रीसेट होती है। Quota बजट है। इसे सावधानी से खर्च करें।

Burst allowance वह थोड़ी-सी अतिरिक्त जगह है जो API कुछ समय के लिए दे सकती है। अगर steady rate 5 per second है, तब भी 20 requests की burst ठीक हो सकती है। लेकिन शर्त यह है कि औसत फिर भी नियम में फिट होना चाहिए।

Backoff अगली retry से पहले का ठहराव है। कोई क्लाइंट जो 250 मिलीसेकंड, फिर 500 मिलीसेकंड, फिर 1 सेकंड रुकता है, वह धैर्यवान व्यवहार कर रहा है। जो क्लाइंट तुरंत retry करता है, वह टूटे हुए सिस्टम जैसा व्यवहार कर रहा है।

Ban window वह अवधि है जिसमें उल्लंघन के बाद एक्सचेंज और अनुरोधों को रोक देता है। Weighted requests वे कॉल्स हैं जो 1 यूनिट से ज़्यादा गिनी जाती हैं। अगर एक एंडपॉइंट का वज़न 10 है, तो ऐसे 10 कॉल्स वही अनुमति खपा सकते हैं जो 100 हल्के कॉल्स लेते। यही वह बारीक़ी है जो 3 बजे सुबह किसी बॉट को तोड़ देती है।

8. उदाहरण: आम लिमिट परिदृश्य

उदाहरण 1: एक प्राइस-चेकिंग ऐप। मान लीजिए ऐप 8 पेयर्स पर नज़र रखता है और हर 5 सेकंड में रिफ्रेश करता है। यह कम भार वाला लगता है, लेकिन अगर हर रिफ्रेश एक अलग पब्लिक एंडपॉइंट को हिट करता है और एक्सचेंज सिर्फ़ 10 requests per second की अनुमति देता है, तो ऐप तब तक ठीक रह सकता है जब तक और यूज़र्स जुड़कर वही सर्वर 50 sessions को सेवा देने न लगे। फिर लिमिट दिखने लगती है।

उदाहरण 2: एक ट्रेडिंग बॉट। बॉट सिग्नल चेक करता है, ऑर्डर्स लगाता है, पुराने ऑर्डर्स कैंसिल करता है, और fills की पुष्टि करता है। अगर हर action भारी वज़न वाले authenticated endpoints इस्तेमाल करता है, तो बॉट सिर्फ़ कुछ तेज़ चक्रों के बाद लिमिट छू सकता है। एक सावधान बॉट cached state, कम balance checks, और हर फेल्योर के बाद बढ़ती retry delay का इस्तेमाल करता है।

उदाहरण 3: डेटा-भारी बैकफ़िल जॉब। 180 दिनों का candle data डाउनलोड करने वाली research script लिमिट्स को काम खत्म होने से बहुत पहले ट्रिगर कर सकती है। अगर एक्सचेंज हर अनुरोध में सिर्फ़ 200 rows लौटाता है, तो जॉब को सैकड़ों कॉल्स की ज़रूरत पड़ सकती है। बेहतर तरीका यह है कि दिन के हिसाब से बैच करें, chunks के बीच रुकें, और किसी failure के बाद आख़िरी साफ़ timestamp से फिर शुरू करें।

अगर आप इन स्थितियों में किसी प्लेटफ़ॉर्म की तुलना कर रहे हैं, तो एक्सचेंज का चुनाव कोड जितना ही महत्वपूर्ण है। क्रिप्टो एक्सचेंज कैसे चुनें जैसी व्यावहारिक गाइड तब मदद करती है, जब आपको तय करना हो कि API डिज़ाइन आपके workflow से मेल खाता है या नहीं, सिर्फ़ यह नहीं कि ट्रेडिंग स्क्रीन अच्छी दिखती है या नहीं।

एक दूसरा तरह का उदाहरण भी उल्लेखनीय है: एक देखने में साफ़ API, जो लोड के नीचे फिर भी खराब व्यवहार करती है। कुछ प्रोजेक्ट्स sandbox में ठीक लगते हैं और फिर live endpoints पर असफल हो जाते हैं क्योंकि production में limit rules ज़्यादा कड़े होते हैं। इसी वजह से केवल test data कभी काफ़ी नहीं होता।

एक और व्यावहारिक बात। अगर आप किसी client को bans से बचाने की कोशिश कर रहे हैं, तो क्रिप्टोकरेंसी एक्सचेंज की वैधता कैसे जाँचें वाला लेख यह देखने में मदद कर सकता है कि प्लेटफ़ॉर्म साफ़ नियम, support contacts और consistent API behavior प्रकाशित करता है या नहीं, इससे पहले कि आप उस पर live traffic भरोसे के साथ चलाएँ।

बॉट या डैशबोर्ड बनाने वाले पाठकों के लिए सबसे साफ़ समाधान आम तौर पर “तेज़ भेजो” नहीं होता। यह “कम भेजो” होता है। 3 सेकंड के लिए results cache करें, duplicate calls रोकें, और एक ही cycle में एक ही balance दो बार न माँगें। यही छोटी-सी अनुशासन API को शांत और logs को पढ़ने लायक रखती है।

एक आख़िरी बात: अगर कोई documentation page इतना अस्पष्ट है कि आप यह तय ही न कर सकें कि एक request का वज़न 1 है या 5, तो उसे पहेली नहीं, चेतावनी समझें। support से exact limit, reset window, और overrun की penalty पूछें। ये सजावटी विवरण नहीं हैं; यही तय करते हैं कि integration अपनी पहली व्यस्त घड़ी पार कर पाएगा या नहीं।