Genesis Arbitrage

Genesis Arbitrage · · 3 मिनट में पढ़ें

HTTP 429 Too Many Requests

HTTP 429 Too Many Requests वह स्टेटस कोड है जो सर्वर तब लौटाता है जब क्लाइंट ने कम समय में बहुत ज़्यादा अनुरोध भेज दिए हों और rate limit से टकरा गया हो। यह कोड 2012 में RFC 6585 में आया। मानक यह तय नहीं करता कि अनुरोध कैसे गिने जाएँ: प्रति key, IP पते या resource के हिसाब से, प्रति सेकंड या प्रति घंटा; इसलिए हर सेवा अपने नियम खुद तय करती है।

429 को कैसे संभालें

यह फ़ंक्शन funding spread माँगता है और 429 तथा 503 जवाबों के बाद दोबारा कोशिश करता है:

import os
import time
import requests

URL = "https://api.genesisarbitrage.com/v1/funding/spread"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}

def get_with_retry(params, attempts=5):
    delay = 1
    for _ in range(attempts):
        r = requests.get(URL, headers=HEADERS,
                         params=params, timeout=10)
        if r.status_code not in (429, 503):
            r.raise_for_status()
            return r.json()["data"]
        wait = r.headers.get("Retry-After", "")
        # सर्वर का विराम अगर दिया हो, वरना 1, 2, 4… सेकंड
        time.sleep(int(wait) if wait.isdigit() else delay)
        delay = min(delay * 2, 60)
    raise RuntimeError("still rate limited: poll less often")

rows = get_with_retry({"min_spread": 0.05})
print("coins with a funding spread of 0.05% or more:", len(rows))

विराम को दोगुना करने को exponential backoff कहते हैं। बिना विराम के retry पर लगभग तय है कि फिर 429 मिलेगा। अगर bot की कई कॉपियाँ अनुरोध भेजती हैं, तो हर विराम में सेकंड का एक यादृच्छिक अंश जोड़ें, ताकि उनके retry एक ही पल में न पहुँचें।

Genesis API में 429

Genesis API 429 लौटाता है, जवाब की body में दो में से एक कोड और Retry-After header के साथ:

कोडकबक्या करें
rate_limitedप्रति सेकंड अनुरोध सीमा पार: Trial में 1 से Max में 15 तकRetry-After तक रुकें, अनुरोध समय में फैलाएँ
download_limitedप्रति key हर 10 सेकंड में 60 MB से ज़्यादा compressed डेटाविंडो ख़त्म होने तक रुकें, फ़िल्टर और coin से अनुरोध सीमित करें
{
  "success": false,
  "error": {
    "code": "rate_limited",
    "message": "Requests per second limit exceeded."
  }
}

सीमा से ऊपर के अनुरोधों का कभी बिल नहीं बनता: सिर्फ़ 200 जवाब ही कॉल गिना जाता है, और 429, किसी भी दूसरी त्रुटि की तरह, आपका कोटा खर्च नहीं करता। फिर भी त्रुटियाँ प्रति सेकंड अनुरोध सीमा में गिनी जाती हैं, इसलिए तेज़ retry नए 429 ला देते हैं। X-RateLimit-Remaining header मौजूदा विंडो में बचा हिस्सा दिखाता है और X-Quota-Remaining बचा हुआ कोटा।

यह भी देखें: API polling, ETag और If-None-Match, Genesis API दस्तावेज़ में एरर, Genesis API की सीमाएँ।

सवाल और जवाब

429 और 503 में क्या फ़र्क है?

429 का मतलब है कि आप बहुत जल्दी-जल्दी माँग रहे हैं। Genesis API में snapshot_not_ready कोड वाला 503 बताता है कि डेटा दोबारा बन रहा है या उसका स्रोत रीस्टार्ट हो रहा है: Retry-After सेकंड बाद फिर कोशिश करें।

मेरा bot कम अनुरोध भेजता है, फिर भी 429 क्यों मिलता है?

सीमा प्रति key है, इसलिए एक key साझा करने वाली दो स्क्रिप्टें एक ही सीमा बाँटती हैं। दूसरा कारण फ़िल्टर के बिना बार-बार पूरा डाउनलोड है, जो download_limited की मात्रा-सीमा से टकराता है।