API polling
API polling, güncel veriyi zamanlanmış tekrarlı isteklerle almaktır: istemci her N saniyede bir sunucuya neyin değiştiğini sorar. Botlar ve panolar REST API ile böyle çalışır; REST API kendiliğinden hiçbir şey göndermez, her sorgu düz bir HTTP GET'tir.
Aralık ve veri tazeliği
Verinin güncellendiğinden daha sık sorgulamak bir şey kazandırmaz: sunucu aynı anlık görüntüyü döndürür. Genesis API'de veri tazeliği plana bağlıdır: çıktı Trial'da 60, Start'ta 30, Pro'da 10 ve Max'te 5 saniyede bir yenilenir; bu değer meta.freshness_sec alanında gelir. Anlık görüntünün oluşturulma zamanı meta.updated_at içindedir; art arda iki yanıtta aynı değer görmek, ikinci isteğin boşa gittiği anlamına gelir.
Varsayımsal örnek: Trial'da bir bot bir endpoint'i her 10 saniyede sorguluyor. Dakikadaki altı istekten yalnızca biri yeni veri getirir; diğer beşi anlık görüntüyü tekrarlar ve bot If-None-Match göndermiyorsa yine kota harcar.
import os
import time
import requests
URL = "https://api.genesisarbitrage.com/v1/arbitrage/spot-spot"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}
while True:
r = requests.get(URL, headers=HEADERS,
params={"min_spread": 1}, timeout=10)
if r.status_code in (429, 503):
time.sleep(int(r.headers.get("Retry-After", "5")))
continue
r.raise_for_status()
meta = r.json()["meta"]
print("pairs:", meta["count"], "snapshot:", meta["updated_at"])
# planın yenileme adımından daha sık sorgulamak anlamsız
time.sleep(meta["freshness_sec"])
Polling kaç çağrı harcar
Tek bir endpoint'i her 10 saniyede sorgulamak: 2.592.000 ÷ 10 = 30 günde 259.200 çağrı. Genesis API kotası da 30 günü kapsar.
| Plan ve kota | Aralık = tazelik | Endpoint başına çağrı | Kota dahilinde endpoint |
|---|---|---|---|
| Trial, 500K | 60 sn | 43.200 | 11 |
| Start, 2M | 30 sn | 86.400 | 23 |
| Pro, 5M | 10 sn | 259.200 | 19 |
| Max, 10M | 5 sn | 518.400 | 19 |
Hesap 304 yanıtlarını dikkate almaz. Pro'da her 10 saniyede sorgulanan 19 endpoint, 5 olan limite karşı ortalama saniyede 1,9 istek eder. İstekleri zamana yayın: 19 isteği aynı anda göndermek limiti aşar ve sunucu HTTP 429 ile yanıt verir.
Polling, WebSocket ve webhook
| Yöntem | Aktarımı kim başlatır | Ne için uygun |
|---|---|---|
| Polling | İstemci, zamanlamaya göre | Bilinen adımla güncellenen veri; her HTTP istemcisi yeter |
| WebSocket | Sunucu, açık bir bağlantı üzerinden | Kesintisiz değişiklik akışı: borsa emir defterleri ve işlemler |
| Webhook | Sunucu, sizin URL'nize istek göndererek | Seyrek olaylar, herkese açık bir HTTPS endpoint'iniz varsa |
Genesis API'de WebSocket ve webhook yoktur: veri REST üzerinden sunulur, tazeliği plan belirler. meta.freshness_sec aralığıyla sorgulamak onunla çalışmanın standart yoludur; trafiği ve çağrıları azaltma yöntemleri Limitlere takılmadan API nasıl sorgulanır yazısındadır.
Ayrıca bakın: rate limit, dokümantasyonda planlar ve limitler, yanıt formatı, Genesis API limitleri.
Sorular ve cevaplar
Genesis API'yi ne sıklıkla sorgulamalıyım?
Planınızın meta.freshness_sec değerinden daha sık değil: Trial'da 60, Start'ta 30, Pro'da 10 ve Max'te 5 saniyede bir. Daha sık sorgulamak aynı veriyi döndürür.