تأخیر (Latency)
تأخیر (latency) فاصلهٔ زمانی بین رویدادی در بازار و رسیدن داده دربارهٔ آن به کد شماست. مثال فرضی: معاملهای ساعت 12:00:00 در صرافی ثبت میشود و اسکریپت شما قیمت جدید را ساعت 12:00:12 میگیرد؛ تأخیر 12 ثانیه است.
تأخیر از چه ساخته میشود
| مرحله | چه چیزی زمان اضافه میکند |
|---|---|
| صرافی | انتشار معامله یا تغییر دفتر در API آن |
| جمعآوری | دریافت داده با WebSocket یا REST، اتصال مجدد |
| محاسبه | تطبیق صرافیها، محاسبهٔ دوبارهٔ اسپردها و دفترها |
| تحویل | گام تازهسازی خروجی پلن و شبکه تا سرور شما |
| کد شما | فاصلهٔ پولینگ و پردازش پاسخ |
بعضی از این مراحل در فیلدهای پاسخ Genesis API دیده میشوند. meta.updated_at زمان ساخت اسنپشات است و meta.freshness_sec تأخیر خروجی در پلن شما: 60، 30، 10 یا 5 ثانیه. دفترهای سفارش نشانگر خودشان را دارند: age_sec سن دفتر است و stale دفتر قدیمیتر از 30 ثانیه را علامت میزند؛ دفترها 5 تا 20 ثانیه از صرافی عقبترند (دفتر سفارش بازار در مستندات).
قیمت کهنه در آربیتراژ
مثال فرضی: اسنپشاتی که 15 ثانیه پیش گرفته شده کوینی را در صرافی A به 10.00 دلار و در صرافی B به 10.12 دلار نشان میدهد.
| لحظه | قیمت در A | قیمت در B | اسپرد |
|---|---|---|---|
| در اسنپشات | 10.00 دلار | 10.12 دلار | 1.2% |
| الان در صرافی | 10.00 دلار | 10.03 دلار | 0.3% |
دو معامله با کارمزد تیکر 0.1% برای هر کدام 0.2% میخورند، پس بهجای 1.2% اسنپشات فقط 0.1% میماند. هرچه تأخیر بیشتر باشد، ربات بیشتر اسپردی را میبیند که در صرافی دیگر وجود ندارد.
زمان پاسخ و تازگی داده
زمان پاسخ سرور و تازگی داده، یعنی اینکه اسنپشات چند وقت پیش ساخته شده، دو عدد متفاوتاند. مثال فرضی: پاسخ در 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 چقدر است؟
خروجی در Trial هر 60 ثانیه، در Start هر 30، در Pro هر 10 و در Max هر 5 ثانیه تازه میشود؛ مقدار دقیق برای کلید شما در meta.freshness_sec میآید. فاصلهٔ پولینگ شما و شبکه به آن اضافه میشوند.