تازگی داده
تازگی داده (data freshness) سنِ داده در لحظه رسیدن به شماست: چند ثانیه از ساخته شدن داده تا رسیدن پاسخ گذشته است. در آربیتراژ ارز دیجیتال تازگی تعیین میکند اسپرد هنوز زنده است یا نه: جفتی که با قیمتهای یکدقیقهای ارزشگذاری شده ممکن است پیش از رسیدن درخواست شما بسته شده باشد.
تازگی بر اساس پلن Genesis API
هسته Genesis Arbitrage دادهها را هر ثانیه بهروز میکند و پلن Genesis API شما تعیین میکند خروجی API هر چند وقت یک بار بهروز شود. هر پاسخ مقدار پلن شما را در meta.freshness_sec و زمان ساخت داده را در meta.updated_at دارد (قالب پاسخ).
| پلن | freshness_sec | حداکثر نرخ پرسوجو |
|---|---|---|
| Trial | 60 | هر 60 ثانیه یک بار |
| Start | 30 | هر 30 ثانیه یک بار |
| Pro | 10 | هر 10 ثانیه یک بار |
| Max | 5 | هر 5 ثانیه یک بار |
پرسوجو با سرعتی بیشتر از freshness_sec همان اسنپشات را برمیگرداند. ETag پاسخ قبلی را در If-None-Match بفرستید: اگر چیزی تغییر نکرده باشد، API با 304 و بدون بدنه پاسخ میدهد و این پاسخ از سهمیه کم نمیشود (ETag و If-None-Match، پولینگ API). هنگام بازسازی داده 503 snapshot_not_ready میگیرید؛ پس از Retry-After ثانیه دوباره تلاش کنید.
سن دفتر سفارش و پلتفرم
دفترهای سفارش زمان خودشان را دارند. در /orderbooks/book و /orderbooks/coin/{coin} هر دفتر شامل book_ts (زمان دفتر)، age_sec (سن آن به ثانیه) و stale است که وقتی دفتر از 30 ثانیه قدیمیتر باشد true است. دفترها 5 تا 20 ثانیه از صرافی عقباند (دفتر سفارش بازار).
age_sec هنگام ساخت پاسخ محاسبه میشود، بنابراین در لحظه دریافت، now − book_ts دقیقتر است. برای بازارهای پیشبینی، /predictions/platforms تازگی را به تفکیک پلتفرم نشان میدهد: quotes_at زمان آخرین قیمتهای آن و full_scan_at زمان آخرین اسکن کامل آن است.
بررسی در کد
دفترهای سفارش در پلنهای Pro و Max هستند، اما بررسی meta برای همه endpointها یکسان است.
import os
import time
import requests
URL = "https://api.genesisarbitrage.com/v1/orderbooks/book"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}
def get_json(params, tries=3):
for _ in range(tries):
r = requests.get(URL, headers=HEADERS, params=params,
timeout=10)
if r.status_code in (429, 503): # rate limit یا بازسازی
time.sleep(int(r.headers.get("Retry-After", "5")))
continue
r.raise_for_status()
return r.json()
raise RuntimeError("data not ready")
params = {"exchange": "Binance", "market": "spot", "coin": "BTC"}
body = get_json(params)
now = time.time()
meta = body["meta"]
print(f"snapshot age {now - meta['updated_at']:.0f} s,"
f" plan freshness {meta['freshness_sec']} s")
book = body["data"]
ts = book["book_ts"]
if book["stale"] or ts is None or now - ts > 30:
print("order book is stale, skipping the signal")
همچنین ببینید: محدودیتهای Genesis API، پولینگ API بدون رسیدن به محدودیتها، ریسکهای خودکارسازی، دفتر سفارش.
پرسش و پاسخ
تازگی با تأخیر چه فرقی دارد؟
تأخیر کل مسیر از رویداد روی صرافی تا کد شماست: انتشار توسط صرافی، جمعآوری، محاسبه، تحویل و فاصله پولینگ شما. تازگی بخشی است که در پاسخ میبینید: اسنپشات چند وقت پیش ساخته شده است. ممکن است سرور در کسری از ثانیه پاسخ دهد و با این حال اسنپشاتی یکدقیقهای برگرداند.