Genesis Arbitrage

Genesis Arbitrage · · 3 دقائق قراءة

خطأ HTTP 429 Too Many Requests

HTTP 429 Too Many Requests هو رمز الحالة الذي يعيده الخادم عندما يرسل العميل طلبات أكثر من اللازم في فترة قصيرة ويتجاوز حد المعدل (rate limit). أُضيف الرمز في RFC 6585 عام 2012. لا يحدد المعيار كيفية عدّ الطلبات: لكل مفتاح أو عنوان 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 يعني أنك تطلب بوتيرة عالية. أما 503 مع الرمز snapshot_not_ready في Genesis API فيعني أن البيانات تُعاد بناؤها أو أن مصدرها يُعاد تشغيله: أعد المحاولة بعد Retry-After ثانية.

لماذا أحصل على 429 مع أن البوت يرسل طلبات قليلة؟

الحد مرتبط بالمفتاح، فإذا شارك سكربتان المفتاح نفسه تشاركا الحد. وقد يكون السبب تحميلات كاملة متكررة دون مرشحات تصطدم بسقف الحجم download_limited.