Genesis Arbitrage

Genesis Arbitrage · · 3 dk okuma

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ı).

Planfreshness_secEn sık sorgulama
Trial6060 sn'de bir
Start3030 sn'de bir
Pro1010 sn'de bir
Max55 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.