حداثة البيانات
حداثة البيانات (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، وقيمته true عندما يزيد عمر الدفتر على 30 ث. تتأخر الدفاتر عن المنصة بـ 5–20 ثانية (دفتر أوامر السوق).
يُحسب age_sec لحظة بناء الاستجابة، لذا فإن now − book_ts لحظة الاستلام أدق. أما لأسواق التنبؤات فيعرض /predictions/platforms الحداثة لكل منصة: quotes_at وقت آخر أسعارها وfull_scan_at وقت آخر مسح كامل لها.
التحقق في الكود
دفاتر الأوامر متاحة في خطتي Pro وMax، أما فحص meta فهو نفسه لكل نقاط النهاية.
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): # حد المعدل أو إعادة بناء
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 دون بلوغ الحدود، مخاطر الأتمتة، دفتر الأوامر.
أسئلة وأجوبة
ما الفرق بين الحداثة وزمن الاستجابة؟
زمن الاستجابة هو المسار الكامل من الحدث على المنصة إلى كودك: نشر المنصة له، والجمع، والحساب، والتسليم، وفترة استعلامك. أما الحداثة فهي الجزء الذي تراه في الاستجابة: منذ متى بُنيت اللقطة. قد يردّ الخادم في جزء من الثانية ومع ذلك يعيد لقطة عمرها دقيقة.