Genesis Arbitrage

Genesis Arbitrage · · 3 دقیقه مطالعه

خطای HTTP 429 Too Many Requests

HTTP 429 Too Many Requests کد وضعیتی است که سرور وقتی برمی‌گرداند که کلاینت در مدت کوتاه درخواست‌های زیادی فرستاده و به محدودیت نرخ (rate limit) خورده است. این کد در سال 2012 در RFC 6585 معرفی شد. استاندارد نمی‌گوید درخواست‌ها چگونه شمرده شوند: به ازای هر کلید، آدرس IP یا منبع، در ثانیه یا در ساعت؛ بنابراین هر سرویس قواعد خودش را دارد.

نحوهٔ مدیریت 429

این تابع اسپرد فاندینگ را درخواست می‌کند و پس از پاسخ‌های 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 نام دارد. تلاش مجدد بدون وقفه به احتمال زیاد دوباره 429 می‌گیرد. اگر چند نسخه از ربات درخواست می‌فرستند، به هر وقفه کسر تصادفی از ثانیه اضافه کنید تا تلاش‌های مجدد آن‌ها هم‌زمان نرسند.

429 در Genesis API

Genesis API کد 429 را با یکی از دو کد در بدنهٔ پاسخ و هدر Retry-After برمی‌گرداند:

کدچه زمانیچه کنیم
rate_limitedعبور از محدودیت درخواست در ثانیه: از 1 در Trial تا 15 در Maxتا پایان Retry-After صبر کنید و درخواست‌ها را در زمان پخش کنید
download_limitedبیش از 60 مگابایت داده فشرده در هر 10 ثانیه برای هر کلیدتا پایان پنجره صبر کنید و درخواست را با فیلترها و coin محدود کنید
{
  "success": false,
  "error": {
    "code": "rate_limited",
    "message": "Requests per second limit exceeded."
  }
}

درخواست‌های بیش از محدودیت هرگز صورتحساب نمی‌شوند: فقط پاسخ 200 یک فراخوانی حساب می‌شود و 429 مانند هر خطای دیگر از سهمیهٔ شما کم نمی‌کند. با این حال خطاها در محدودیت درخواست در ثانیه شمرده می‌شوند، پس تلاش‌های مجدد سریع 429 تازه می‌آورند. هدر X-RateLimit-Remaining باقی‌ماندهٔ پنجرهٔ فعلی و X-Quota-Remaining باقی‌ماندهٔ سهمیه را نشان می‌دهد.

همچنین ببینید: پولینگ API، ETag و If-None-Match، خطاها در مستندات Genesis API، محدودیت‌های Genesis API.

پرسش و پاسخ

429 چه فرقی با 503 دارد؟

429 یعنی بیش از حد درخواست می‌دهید. در Genesis API، 503 با کد snapshot_not_ready یعنی داده در حال بازسازی است یا منبع آن دوباره راه‌اندازی می‌شود: بعد از Retry-After ثانیه دوباره تلاش کنید.

چرا با وجود درخواست‌های کم ربات 429 می‌گیرم؟

محدودیت به ازای هر کلید است، پس دو اسکریپت با یک کلید یک محدودیت را تقسیم می‌کنند. علت دیگر دانلودهای کامل مکرر بدون فیلتر است که به سقف حجم download_limited می‌خورند.