Genesis Arbitrage

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

حد المعدل (Rate limit)

حد المعدل (rate limit) يحدد عدد الطلبات التي يستطيع العميل إرسالها إلى API في وحدة زمنية. عند تجاوز الحد يجيب الخادم بـ 429 Too Many Requests المعرّفة في RFC 6585، وقد يضيف ترويسة Retry-After تحدد كم ثانية تنتظر (خطأ HTTP 429).

المعدل والحصة

عادةً يوجد حدّان: المعدل (طلبات في الثانية أو الدقيقة) والحصة (استدعاءات في اليوم أو الشهر). في Genesis API يتوقف الاثنان على الخطة:

الخطةطلبات في الثانيةاستدعاءات لكل 30 يومًاتدوم الحصة بأقصى معدل
Trial1500K5.8 يوم
Start22M11.6 يوم
Pro55M11.6 يوم
Max1510M7.7 يوم

يفترض العمود الأخير طلبات متواصلة بأقصى معدل واستجابة 200 لكل طلب. في Pro: 5 × 86,400 = 432,000 طلب في اليوم، و5,000,000 / 432,000 ≈ 11.6 يوم. حد الثانية سقف للدفعات المفاجئة، والحصة تحدد الوتيرة المتوسطة: 30 يومًا تساوي 2,592,000 ثانية، فتتحمل Pro متوسطًا قدره 5,000,000 / 2,592,000 ≈ 1.93 طلب في الثانية.

استجابات 200 وحدها تستهلك الحصة؛ استجابات 304 والأخطاء لا تستهلكها لكنها تُحتسب ضمن حد الطلبات في الثانية. وحجم التنزيل محدود بشكل مستقل: 60 ميغابايت من البيانات المضغوطة لكل 10 ثوانٍ لكل مفتاح، وما يزيد على ذلك يحصل على 429 download_limited.

كيف تبقى ضمن الحد

كل استجابة من Genesis API تُبلغ عن حالة الحدود في الترويسات:

الترويسةماذا تعرض
X-RateLimit-Limitحد الطلبات في الثانية لخطتك
X-RateLimit-Remainingالطلبات المتبقية في النافذة الحالية
X-RateLimit-Resetوقت unix لإعادة ضبط النافذة
Retry-Afterثوانٍ الانتظار قبل الإعادة (مع 429 و503)

تظهر الحصة في X-Quota-Limit وX-Quota-Remaining وX-Quota-Reset وفي نقطة النهاية الاستخدام /account/usage. الكود التالي يستطلع ثلاث نقاط نهاية تباعًا: عندما لا تبقى طلبات في النافذة ينتظر 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، حداثة البيانات، الخطط والحدود، حدود Genesis API، كيف تستطلع API دون بلوغ الحدود.

أسئلة وأجوبة

ماذا يحدث عند نفاد الحصة الشهرية؟

الطلبات الزائدة على الحصة لا تُحاسَب أبدًا. انتظر إعادة الضبط (وقتها في X-Quota-Reset) أو انتقل إلى خطة أعلى: تسري الخطة الجديدة فورًا، وتبدأ الحصة من الصفر، ويسقط ما تبقى من الخطة القديمة.

هل أستطيع تجاوز الحد بمفتاح ثانٍ؟

لا. للحساب مفتاح واحد، واستخدام عدة حسابات أو تدوير عناوين IP لتجاوز الحد يخالف القواعد. إذا نقصتك الاستدعاءات فقلّل غير الضروري منها بالمرشحات ومعامل coin وETag مع If-None-Match، أو انتقل إلى خطة أعلى.