Genesis Arbitrage

Genesis Arbitrage · · 3 dk okuma

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 kotaAralık = tazelikEndpoint başına çağrıKota dahilinde endpoint
Trial, 500K60 sn43.20011
Start, 2M30 sn86.40023
Pro, 5M10 sn259.20019
Max, 10M5 sn518.40019

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öntemAktarımı kim başlatırNe için uygun
Pollingİstemci, zamanlamaya göreBilinen adımla güncellenen veri; her HTTP istemcisi yeter
WebSocketSunucu, açık bir bağlantı üzerindenKesintisiz değişiklik akışı: borsa emir defterleri ve işlemler
WebhookSunucu, sizin URL'nize istek göndererekSeyrek 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.