Genesis Arbitrage

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

الاستعلام الدوري من API (Polling)

الاستعلام الدوري من API (API polling) هو الحصول على بيانات حديثة عبر طلبات متكررة بجدول زمني: كل N ثانية يسأل العميل الخادم عما تغيّر. تعمل البوتات ولوحات المتابعة هكذا مع REST API الذي لا يرسل شيئاً من تلقاء نفسه: كل استعلام هو HTTP GET عادي.

الفاصل وحداثة البيانات

لا فائدة من الاستعلام بوتيرة أسرع من تحديث البيانات: سيعيد الخادم اللقطة نفسها. في Genesis API تعتمد حداثة البيانات على الخطة: يُحدَّث الإخراج كل 60 ثانية في Trial و30 في Start و10 في Pro و5 في Max، وتأتي هذه القيمة في الحقل meta.freshness_sec. وقت بناء اللقطة في meta.updated_at؛ فإذا تكررت القيمة نفسها في استجابتين متتاليتين فالطلب الثاني كان هدراً.

مثال افتراضي: في Trial يستعلم بوت من نقطة نهاية كل 10 ثوانٍ. من الطلبات الستة في الدقيقة يجلب واحد فقط بيانات جديدة؛ والخمسة الباقية تكرر اللقطة وتستهلك الحصة، ما لم يرسل البوت If-None-Match.

import os
import time
import requests

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

while True:
    r = requests.get(URL, headers=HEADERS,
                     params={"min_spread": 1}, timeout=10)
    if r.status_code in (429, 503):
        time.sleep(int(r.headers.get("Retry-After", "5")))
        continue
    r.raise_for_status()
    meta = r.json()["meta"]
    print("pairs:", meta["count"], "snapshot:", meta["updated_at"])
    # الاستعلام أسرع من خطوة تحديث الخطة بلا جدوى
    time.sleep(meta["freshness_sec"])

كم استدعاء يستهلك الاستعلام الدوري

الاستعلام من نقطة نهاية واحدة كل 10 ثوانٍ: 2,592,000 ÷ 10 = 259,200 استدعاء خلال 30 يوماً. وحصة Genesis API تغطي 30 يوماً أيضاً.

الخطة والحصةالفاصل = الحداثةالاستدعاءات لكل نقطة نهايةنقاط النهاية ضمن الحصة
Trial، 500K60 ث43,20011
Start، 2M30 ث86,40023
Pro، 5M10 ث259,20019
Max، 10M5 ث518,40019

لا يأخذ الحساب استجابات 304 في الاعتبار. في Pro تعني 19 نقطة نهاية كل 10 ثوانٍ في المتوسط 1.9 طلب في الثانية مقابل حد قدره 5. وزّع الطلبات على الزمن: 19 طلباً دفعة واحدة تتجاوز الحد، وسيجيب الخادم بـ HTTP 429.

الاستعلام الدوري وWebSocket وWebhook

الأسلوبمن يبدأ النقليناسب
الاستعلام الدوريالعميل، بجدول زمنيبيانات تتحدث بخطوة معروفة؛ يكفي أي عميل HTTP
WebSocketالخادم، عبر اتصال مفتوحتدفق مستمر من التغييرات: دفاتر أوامر البورصات وصفقاتها
Webhookالخادم، بطلب إلى رابطكأحداث نادرة، إذا كانت لديك نقطة HTTPS عامة

لا يوجد في Genesis API لا WebSocket ولا Webhook: البيانات تُقدَّم عبر REST، وتحدد الخطة الحداثة. الاستعلام بوتيرة meta.freshness_sec هو الأسلوب المعتمد، وطرق تقليل الحركة والاستدعاءات في كيف تستعلم من API دوريا دون الوصول إلى الحدود.

انظر أيضاً: حد المعدل، الخطط والحدود في التوثيق، صيغة الاستجابة، حدود Genesis API.

أسئلة وأجوبة

كل كم ثانية أستعلم من Genesis API؟

بوتيرة لا تزيد على meta.freshness_sec في خطتك: كل 60 ثانية في Trial و30 في Start و10 في Pro و5 في Max. الاستعلام الأسرع يعيد البيانات نفسها.