زمن التأخر (Latency)
زمن التأخر (latency) هو الوقت بين وقوع حدث في السوق ووصول بيانات عنه إلى كودك. مثال افتراضي: تُنفَّذ صفقة في البورصة عند 12:00:00 ويستلم سكربتك السعر الجديد عند 12:00:12، أي أن زمن التأخر 12 ثانية.
مم يتكوّن زمن التأخر
| المرحلة | ما الذي يضيف وقتاً |
|---|---|
| البورصة | نشر صفقة أو تغيير في الدفتر عبر واجهتها |
| الجمع | استلام البيانات عبر WebSocket أو REST وإعادة الاتصال |
| الحساب | مطابقة البورصات وإعادة حساب السبريدات والدفاتر |
| التسليم | خطوة تحديث الإخراج في الخطة والشبكة إلى خادمك |
| كودك | فاصل الاستعلام ومعالجة الاستجابة |
تظهر بعض هذه المراحل في حقول استجابة Genesis API. meta.updated_at هو وقت بناء اللقطة، وmeta.freshness_sec هو تأخر الإخراج في خطتك: 60 أو 30 أو 10 أو 5 ثوانٍ. ولدفاتر الأوامر علاماتها الخاصة: age_sec عمر الدفتر، وstale يشير إلى دفتر عمره أكثر من 30 ثانية؛ وتتأخر الدفاتر عن البورصة بين 5 و20 ثانية (دفتر أوامر السوق في التوثيق).
الأسعار القديمة في الأربيتراج
مثال افتراضي: لقطة أُخذت قبل 15 ثانية تُظهر عملة بسعر 10.00$ في البورصة A و10.12$ في البورصة B.
| اللحظة | السعر في A | السعر في B | السبريد |
|---|---|---|---|
| في اللقطة | 10.00$ | 10.12$ | 1.2% |
| في البورصة الآن | 10.00$ | 10.03$ | 0.3% |
صفقتان بعمولة تيكر قدرها 0.1% لكل منهما تلتهمان 0.2%، فيتبقى 0.1% فقط بدل 1.2% في اللقطة. وكلما زاد زمن التأخر، رأى البوت أكثر سبريداً لم يعد موجوداً في البورصة.
زمن الاستجابة وحداثة البيانات
زمن استجابة الخادم وحداثة البيانات، أي منذ متى بُنيت اللقطة، رقمان مختلفان. مثال افتراضي: تصل الاستجابة خلال 0.2 ثانية بينما عمر اللقطة بداخلها 9 ثوانٍ. يمكنك قياس الاثنين:
import os
import time
import requests
r = requests.get(
"https://api.genesisarbitrage.com/v1/arbitrage/spot-spot",
headers={"X-API-Key": os.environ["GENESIS_API_KEY"]},
params={"coin": "BTC"},
timeout=10,
)
r.raise_for_status()
meta = r.json()["meta"]
# زمن الاستجابة: من إرسال الطلب إلى تحليل الترويسات
print("response time:", round(r.elapsed.total_seconds(), 2), "s")
# عمر البيانات: الوقت منذ بناء اللقطة
print("data age:", round(time.time() - meta["updated_at"]), "s")
يُحسب عمر البيانات وفق ساعة خادمك: وإذا انحرفت الساعة دخل الخطأ في النتيجة، فحافظ على مزامنة الوقت (NTP).
انظر أيضاً: الاستعلام الدوري من API، WebSocket، صيغة الاستجابة، مخاطر الأتمتة: البيانات القديمة والأخطاء والمفاتيح.
أسئلة وأجوبة
ما زمن التأخر في Genesis API؟
يُحدَّث الإخراج كل 60 ثانية في Trial و30 في Start و10 في Pro و5 في Max؛ والقيمة الدقيقة لمفتاحك تأتي في meta.freshness_sec. ويضيف إليها فاصل استعلامك والشبكة.