پولینگ 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 روزه است.
| پلن و سهمیه | فاصله = تازگی | فراخوانی برای هر endpoint | endpointهای قابل پوشش با سهمیه |
|---|---|---|---|
| Trial، 500K | 60 ثانیه | 43,200 | 11 |
| Start، 2M | 30 ثانیه | 86,400 | 23 |
| Pro، 5M | 10 ثانیه | 259,200 | 19 |
| Max، 10M | 5 ثانیه | 518,400 | 19 |
این محاسبه پاسخهای 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 ثانیه. پولینگ سریعتر همان داده را برمیگرداند.