Genesis Arbitrage

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

پولینگ API

پولینگ API (API polling) دریافت داده تازه با درخواست‌های تکراری طبق زمان‌بندی است: کلاینت هر N ثانیه از سرور می‌پرسد چه چیزی عوض شده است. ربات‌ها و داشبوردها با REST API همین‌طور کار می‌کنند، چون REST خودش چیزی نمی‌فرستد: هر پولینگ یک HTTP GET ساده است.

فاصله و تازگی داده

سریع‌تر از به‌روزرسانی داده پولینگ کردن فایده‌ای ندارد: سرور همان اسنپ‌شات را برمی‌گرداند. در Genesis API تازگی داده به پلن بستگی دارد: خروجی در Trial هر 60 ثانیه، در Start هر 30، در Pro هر 10 و در Max هر 5 ثانیه تازه می‌شود و این مقدار در فیلد meta.freshness_sec می‌آید. زمان ساخت اسنپ‌شات در meta.updated_at است؛ مقدار یکسان در دو پاسخ پشت سر هم یعنی درخواست دوم هدر رفته است.

مثال فرضی: در Trial رباتی هر 10 ثانیه یک endpoint را پولینگ می‌کند. از شش درخواست در دقیقه فقط یکی داده تازه می‌آورد؛ پنج‌تای دیگر اسنپ‌شات را تکرار می‌کنند و سهمیه مصرف می‌کنند، مگر اینکه ربات 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"])

پولینگ چند فراخوانی مصرف می‌کند

پولینگ یک endpoint هر 10 ثانیه: 2,592,000 ÷ 10 = 259,200 فراخوانی در 30 روز. سهمیهٔ Genesis API هم 30 روزه است.

پلن و سهمیهفاصله = تازگیفراخوانی برای هر endpointendpointهای قابل پوشش با سهمیه
Trial، 500K60 ثانیه43,20011
Start، 2M30 ثانیه86,40023
Pro، 5M10 ثانیه259,20019
Max، 10M5 ثانیه518,40019

این محاسبه پاسخ‌های 304 را نادیده می‌گیرد. در Pro، 19 endpoint هر 10 ثانیه به‌طور میانگین 1.9 درخواست در ثانیه است در برابر محدودیت 5. درخواست‌ها را پخش کنید: 19 درخواست هم‌زمان از محدودیت می‌گذرد و سرور با HTTP 429 پاسخ می‌دهد.

پولینگ، WebSocket و وب‌هوک

روشچه کسی انتقال را شروع می‌کندمناسب برای
پولینگکلاینت، طبق زمان‌بندیداده‌ای که با گام مشخص به‌روز می‌شود؛ هر کلاینت HTTP کافی است
WebSocketسرور، روی اتصال بازجریان پیوستهٔ تغییرات: دفتر سفارش و معاملات صرافی‌ها
وب‌هوکسرور، با درخواست به URL شمارویدادهای نادر، اگر endpoint عمومی HTTPS دارید

Genesis API نه WebSocket دارد و نه وب‌هوک: داده با REST ارائه می‌شود و پلن تازگی را تعیین می‌کند. پولینگ با فاصلهٔ meta.freshness_sec روش استاندارد کار با آن است؛ راه‌های کم کردن ترافیک و فراخوانی‌ها در چگونه API را بدون رسیدن به محدودیت‌ها پولینگ کنیم آمده است.

همچنین ببینید: محدودیت نرخ، پلن‌ها و محدودیت‌ها در مستندات، قالب پاسخ، محدودیت‌های Genesis API.

پرسش و پاسخ

هر چند وقت یک‌بار Genesis API را پولینگ کنیم؟

بیشتر از meta.freshness_sec پلن خود نه: در Trial هر 60 ثانیه، در Start هر 30، در Pro هر 10 و در Max هر 5 ثانیه. پولینگ سریع‌تر همان داده را برمی‌گرداند.