Veri tazeliği
Veri tazeliği, verinin size ulaştığı andaki yaşıdır: verinin oluşturulması ile yanıtın size gelmesi arasında kaç saniye geçtiği. Arbitrajda bir spread'in hâlâ açık olup olmadığını bu belirler: dakika önceki fiyatlara göre hesaplanan bir çift, isteğiniz gelmeden kapanmış olabilir.
Genesis API planlarına göre tazelik
Genesis Arbitrage çekirdeği veriyi her saniye yeniler; API çıktısının ne sıklıkla güncelleneceğini ise Genesis API planınız belirler. Her yanıt, planınızın değerini meta.freshness_sec alanında, verinin oluşturulma zamanını meta.updated_at alanında taşır (yanıt formatı).
| Plan | freshness_sec | En sık sorgulama |
|---|---|---|
| Trial | 60 | 60 sn'de bir |
| Start | 30 | 30 sn'de bir |
| Pro | 10 | 10 sn'de bir |
| Max | 5 | 5 sn'de bir |
freshness_sec değerinden daha sık sorgulamak aynı anlık görüntüyü döndürür. Önceki yanıtın ETag değerini If-None-Match başlığında gönderin: hiçbir şey değişmediyse API gövdesiz 304 döndürür ve bu yanıt kotanızdan düşmez (ETag ve If-None-Match, API polling). Veri yeniden oluşturulurken 503 snapshot_not_ready alırsınız; Retry-After saniye sonra yeniden deneyin.
Emir defteri ve borsa yaşı
Emir defterlerinin kendi zamanı vardır. /orderbooks/book ve /orderbooks/coin/{coin} yanıtlarında her defterde book_ts (defter zamanı), age_sec (saniye cinsinden yaşı) ve defter 30 sn'den eskiyse true olan stale bulunur. Defterler borsanın 5–20 saniye gerisinde kalır (piyasa emir defteri).
age_sec, yanıt oluşturulurken hesaplanır; bu yüzden aldığınız anda now − book_ts daha doğrudur. Tahmin piyasalarında /predictions/platforms, tazeliği platform bazında gösterir: quotes_at son fiyatların, full_scan_at ise son tam taramanın zamanıdır.
Kodda kontrol
Emir defterleri Pro ve Max planlarındadır; meta kontrolü ise her endpoint için aynıdır.
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 veya yeniden oluşturma
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"anlık görüntü yaşı {now - meta['updated_at']:.0f} sn,"
f" plan tazeliği {meta['freshness_sec']} sn")
book = body["data"]
ts = book["book_ts"]
if book["stale"] or ts is None or now - ts > 30:
print("emir defteri bayat, sinyal atlanıyor")
Ayrıca bakın: Genesis API limitleri, limitlere takılmadan API polling, otomasyon riskleri, emir defteri.
Sorular ve cevaplar
Tazelik gecikmeden nasıl farklıdır?
Gecikme, borsadaki bir olaydan kodunuza kadar olan tüm yoldur: borsanın veriyi yayımlaması, toplama, hesaplama, iletim ve sorgulama aralığınız. Tazelik ise bunun yanıtta görebildiğiniz kısmıdır: anlık görüntünün ne kadar önce oluşturulduğu. Bir sunucu saniyenin çok küçük bir kesrinde yanıt verip yine de bir dakika önceki görüntüyü döndürebilir.