Rate limit
rate limit तय करता है कि क्लाइंट किसी API को प्रति इकाई समय में कितनी request भेज सकता है। लिमिट पार होने पर सर्वर RFC 6585 में परिभाषित 429 Too Many Requests से जवाब देता है, और Retry-After हेडर जोड़ सकता है जो बताता है कि कितने सेकंड रुकना है (HTTP 429 एरर)।
Rate और कोटा
आमतौर पर दो लिमिट होती हैं: rate (प्रति सेकंड या मिनट request) और कोटा (प्रति दिन या महीना calls)। Genesis API में दोनों प्लान पर निर्भर हैं:
| प्लान | प्रति सेकंड request | 30 दिन में calls | पूरी rate पर कोटा टिकता है |
|---|---|---|---|
| Trial | 1 | 500K | 5.8 दिन |
| Start | 2 | 2M | 11.6 दिन |
| Pro | 5 | 5M | 11.6 दिन |
| Max | 15 | 10M | 7.7 दिन |
आख़िरी कॉलम मानता है कि लिमिट की पूरी rate पर लगातार request हो रही हैं और हर जवाब 200 है। Pro के लिए: 5 × 86,400 = 432,000 request प्रति दिन, और 5,000,000 / 432,000 ≈ 11.6 दिन। प्रति सेकंड लिमिट अचानक उछाल की छत है, जबकि कोटा औसत रफ़्तार तय करता है: 30 दिन में 2,592,000 सेकंड होते हैं, इसलिए Pro औसतन 5,000,000 / 2,592,000 ≈ 1.93 request प्रति सेकंड झेलता है।
सिर्फ़ 200 जवाब कोटा खर्च करते हैं; 304 जवाब और त्रुटियाँ नहीं करते, पर वे प्रति सेकंड request की लिमिट में गिने जाते हैं। डाउनलोड की मात्रा अलग से सीमित है: हर key पर 10 सेकंड में 60 MB कम्प्रेस्ड डेटा, और उससे ज़्यादा पर 429 download_limited मिलता है।
लिमिट के भीतर कैसे रहें
Genesis API का हर जवाब लिमिट की स्थिति हेडर में बताता है:
| हेडर | क्या दिखाता है |
|---|---|
X-RateLimit-Limit | आपके प्लान की प्रति सेकंड request लिमिट |
X-RateLimit-Remaining | मौजूदा विंडो में बची request |
X-RateLimit-Reset | विंडो रीसेट होने का unix समय |
Retry-After | दोबारा कोशिश से पहले इंतज़ार के सेकंड (429 और 503 पर) |
कोटा X-Quota-Limit, X-Quota-Remaining, X-Quota-Reset और उपयोग endpoint /account/usage में दिखता है। नीचे का कोड तीन endpoint को एक के बाद एक poll करता है: जब विंडो में request नहीं बचती तो वह X-RateLimit-Reset तक ख़ुद रुकता है, और 429 व 503 पर Retry-After जितना ठहरता है।
import os
import time
import requests
BASE = "https://api.genesisarbitrage.com/v1"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}
PATHS = ("/arbitrage/spot-spot", "/funding/spread",
"/market/open-interest")
def poll_once():
for path in PATHS:
r = requests.get(BASE + path, headers=HEADERS, timeout=10)
if r.status_code in (429, 503):
# सर्वर ठहरने को कहता है; अगला चक्र दोबारा कोशिश करेगा
time.sleep(int(r.headers.get("Retry-After", "1")))
continue
r.raise_for_status()
print(path, "पंक्तियाँ:", r.json()["meta"]["count"])
if r.headers.get("X-RateLimit-Remaining") == "0":
# विंडो ख़त्म: 429 की जगह रीसेट का इंतज़ार करें
reset = int(r.headers.get("X-RateLimit-Reset", "0"))
time.sleep(max(0.0, reset - time.time()))
while True:
poll_once()
time.sleep(10) # Pro की ताज़गी: इससे तेज़ polling से कुछ नहीं मिलता
यह भी देखें: API polling, डेटा की ताज़गी, प्लान और लिमिट, Genesis API की लिमिट, लिमिट छुए बिना API को poll कैसे करें।
सवाल और जवाब
मासिक कोटा ख़त्म हो जाए तो क्या होता है?
कोटे से ऊपर की request का कभी बिल नहीं बनता। रीसेट का इंतज़ार करें (समय X-Quota-Reset में है) या ऊँचे प्लान पर जाएँ: नया प्लान तुरंत लागू होता है, कोटा शून्य से शुरू होता है और पुराने प्लान का बचा हिस्सा ख़त्म हो जाता है।
क्या दूसरी key से लिमिट को टाला जा सकता है?
नहीं। एक अकाउंट की एक key होती है, और लिमिट पार करने के लिए कई अकाउंट या घूमते IP इस्तेमाल करना नियमों का उल्लंघन है। calls कम पड़ें तो फ़िल्टर, coin पैरामीटर और If-None-Match वाले ETag से फ़ालतू calls घटाएँ, या ऊँचे प्लान पर जाएँ।