Genesis Arbitrage

Genesis Arbitrage · · 9 dk okuma

Genesis API limitleri: çağrı kotası, saniyedeki istek, veri tazeliği ve 429 hataları

Kısaca

  • Planınız 30 günlük çağrı kotasını (Trial'da 500 bin, Max'te 10 milyon), saniyedeki istek limitini (1 ile 15 arası) ve veri tazeliğini (60 ile 5 saniye arası) belirler.
  • Kotayı yalnızca 200 yanıtı kullanır. 304 yanıtları ve hatalar ücretsizdir ama saniyedeki istek limitinde yine de yer kaplar; limit aşılırsa sunucu 429 döndürür ve hiçbir şey düşmez.
  • meta.freshness_sec değerinden sık sorgulamak yeni veri getirmez: planınız bu aralıkta bir kez yeni snapshot alır, If-None-Match ise fazladan sorguları ücretsiz 304 yanıtlarına çevirir.

Genesis API limitleri anahtar başına dört sınırdır: 30 günlük dönem için çağrı kotası, saniyedeki istek sayısı olarak rate limit, veri tazeliği ve indirme hacmi. İlk üçünü planınız belirler; indirme hacmi herkes için aynıdır: 10 saniyede 60 MB sıkıştırılmış veri. Herhangi bir limit aşıldığında sunucu 429 hatası döndürür ve hiçbir şey düşmez.

Plana göre limitler

Plan30 günde çağrıSaniyedeki istekTazelik
Trial, 20 $/ay500.000160 sn
Start, 50 $/ay2.000.000230 sn
Pro, 100 $/ay5.000.000510 sn
Max, 200 $/ay10.000.000155 sn

Veri tazeliği, planınızın yeni snapshot aldığı aralıktır: Trial'da her 60 saniye, Max'te her 5 saniye. Yanıtlarda bu değer meta.freshness_sec alanında gelir. 3 aylık ödemede %10, 6 aylık ödemede %20 tasarruf edersiniz. Planların karşılaştırması Genesis API fiyatları sayfasında, kurallar dokümantasyonun Planlar ve limitler bölümünde.

Kotayı ne kullanır

Çağrı, 200 yanıtıdır. 304 yanıtları (veri değişmedi) ile 4xx ve 5xx hataları kotayı kullanmaz, ama saniyedeki istek limitine sayılır. /account/usage isteği çağrı harcamaz.

Kota takvim ayına değil, 30 günlük döneme bağlıdır. Sıfırlanma zamanı X-Quota-Reset başlığında, period_resets_at alanında ve profilinizdeki "sıfırlanma …" satırında yazar. Kota bittiğinde sunucu 429 rate_limited yanıtı verir, Retry-After ise sıfırlanmaya kalan saniyeyi gösterir; bu birkaç gün olabilir.

Rate limit başlıkları

Veri endpoint'inin yanıtı limitlerinizin durumunu taşır (örnek değerler):

BaşlıkÖrnekNe gösterir
X-RateLimit-Limit5Planınızın saniyedeki istek limiti
X-RateLimit-Remaining4Mevcut pencerede kalan istekler
X-RateLimit-Reset1785200001Pencerenin sıfırlanacağı Unix zamanı
X-Quota-Limit500000030 günlük dönem için çağrı kotası
X-Quota-Remaining4815799Dönemde kalan çağrılar
X-Quota-Reset1786492800Kotanın sıfırlanacağı Unix zamanı
Retry-After1429 ve 503 durumunda yeniden denemeden önce beklenecek saniye

Saniyedeki istek penceresi bir saniyedir, bu yüzden normal bir yanıtta X-RateLimit-Reset bir sonraki saniyenin başını gösterir. Örnekte kalan kota: 5.000.000 − 184.201 = 4.815.799 çağrı; /account/usage da aynı sayıları döndürür.

/account/usage endpoint'i

curl "https://api.genesisarbitrage.com/v1/account/usage" \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
  "success": true,
  "data": {
    "plan": "pro",
    "calls_used": 184201,
    "calls_limit": 5000000,
    "rps_limit": 5,
    "freshness_sec": 10,
    "period_resets_at": 1786492800
  },
  "meta": { … }
}
AlanTürAnlamı
planstringPlan: trial, start, pro veya max
calls_usedintMevcut dönemde kullanılan çağrılar
calls_limitintDönem başına çağrı kotası
rps_limitintSaniyedeki istek limiti
freshness_secintVeri gecikmesi, saniye
period_resets_atintKotanın sıfırlanacağı Unix zamanı

Endpoint her planda kullanılabilir ve Kullanım bölümünde anlatılır. Botunuz başlarken, sorgulamaya girişmeden önce planı ve kalan kotayı görmek için bunu çağırın.

429 hataları: rate_limited ve download_limited

YanıtNe zaman gelirNe yapmalı
429 rate_limitedSaniyede planın izin verdiğinden fazla istekRetry-After kadar bekleyin, istekleri aralıklandırın
429 rate_limitedDönem kotası bittiSıfırlanmayı bekleyin veya planı değiştirin
429 rate_limitedFonlama analitiğinin tamamı izin verilenden sık indirildicoin ile dilim alın veya If-None-Match gönderin
429 download_limited10 saniyede 60 MB sıkıştırılmış veriyi aştıRetry-After kadar bekleyin, isteği filtrelerle daraltın

429 Too Many Requests durum kodu RFC 6585 içinde tanımlıdır; orada Retry-After isteğe bağlıdır. Genesis API bunu her 429 yanıtına ekler, her zaman saniye cinsinden.

64 KB'tan küçük yanıtlar indirme hacmine sayılmaz; tüm veri setlerini planınızın tazelik aralığında sorgulamak limite rahatça sığar. coin olmadan fonlama analitiğinin tamamını indirmenin ayrı bir limiti vardır: /funding/analytics/summary ve /funding/analytics/recent 60 saniyede bir, /funding/analytics/daily anahtar başına 300 saniyede bir. coin içeren istekler ve 304 yanıtları sınırlanmaz; ayrıntılar Fonlama analitiği bölümünde.

Plan erişimi ve 403 plan_restricted

PlanNelere erişilir
TrialCEX arbitrajı (Spot – Spot, Spot – Futures, Futures – Futures), fonlama oranları ve fonlama spread'i, Fair – Last, CEX Pumps – Dumps, açık pozisyon, AI sinyalleri, coin araması, /account/usage
StartTrial'daki her şey, ayrıca hisse senetleri /arbitrage/stocks, zincir üstü bölümler /onchain/{section}, exact ve dutch modlarında tahmin arbitrajı, platform durumu
Pro ve MaxTüm endpoint'ler: DEX – Spot, DEX – Futures, Crosschain, DEX Dumps, emir defterleri, fonlama analitiği, tahmin piyasası analitiği, smart money, işlemler, trader'lar, llm ve sport modları, DEX swap'ları, OnChain analitiği ve coin

Planınızın dışındaki bir endpoint 403 döndürür; Start'ta /predictions/arbitrage için mode=sport isteği de öyledir:

{
  "success": false,
  "error": {
    "code": "plan_restricted",
    "message": "This endpoint is not included in your plan."
  }
}

403 kotayı kullanmaz. Yeniden denemek anlamsızdır: erişimi yalnızca daha yüksek bir plan açar.

Yükünüze göre plan nasıl seçilir

Örnek senaryo: bir bot günün 24 saati her 10 saniyede üç endpoint'i sorgular: /arbitrage/spot-spot, /funding/spread ve /market/open-interest.

Aynı bot, her planın tazelik aralığında sorgulandığında:

Tazelik ve sorgu sıklığı30 günde çağrıPlanKota payı
Her 60 sn129.600Trial%26
Her 30 sn259.200Start%13
Her 10 sn777.600Pro%16
Her 5 sn1.555.200Max%16

Her 10 saniyede sorgulamak Pro'dan itibaren mantıklıdır: 777.600 / 5.000.000 = kotanın %15,552'si ve saniyede 5 istek limiti üçünü aynı anda göndermeye yeter. Bot 30 saniyelik eski veriyle idare edebiliyorsa, her 30 saniyede sorgulayan Start planı kotanın 259.200 / 2.000.000 = %12,96'sına mal olur.

Boşa çağrı harcamadan sorgulama: ETag ve Retry-After

Planınız her meta.freshness_sec saniyede yeni snapshot alır; daha sık sorgulamak aynı meta.updated_at ile aynı snapshot'ı döndürür. If-None-Match başlığı olmadan böyle bir yanıt 200'dür ve çağrı harcar. Başlıkla birlikte sunucu gövdesiz 304 döndürür: kotaya dokunulmaz, ama saniyedeki istek limitinde bir yer tutulur.

ETag her yanıtla gelmez. Tam veri setleri onu döndürür, yani filtresiz istekler; aşağıdaki örnekteki /funding/spread gibi. Filtreli yanıtın (coin, min_spread ve diğerleri) ETag'i yoktur ve her sorgu bir çağrıya mal olur: filtreler trafikten, ETag kotadan tasarruf ettirir. Yeniden denemeler ve sıkıştırma, API'yi verimli sorgulama yazısında ve yanıtlar ve hatalar rehberinde anlatılır.

import os
import time

import requests

URL = "https://api.genesisarbitrage.com/v1/funding/spread"
KEY = os.environ["GENESIS_API_KEY"]
etag, pause = None, 30

while True:
    headers = {"X-API-Key": KEY}
    if etag:
        headers["If-None-Match"] = etag
    r = requests.get(URL, headers=headers, timeout=15)
    if r.status_code in (429, 500, 503):
        wait = int(r.headers.get("Retry-After", "5"))
        if wait > 600:  # kota bitti, burada dur
            raise SystemExit(f"Kota bitti, {wait} sn sonra sıfırlanır")
        time.sleep(wait)
        continue
    r.raise_for_status()  # yeniden deneme 401 veya 403'ü düzeltmez
    left = r.headers.get("X-Quota-Remaining")  # olmayabilir
    if left is not None and int(left) < 10_000:
        print("Kota azalıyor:", left)
    if r.status_code == 200:  # 304'te veri değişmemiştir
        etag = r.headers.get("ETag")
        body = r.json()
        pause = body["meta"].get("freshness_sec", pause)
        print(body["meta"]["count"], "coin yanıtta")
    time.sleep(pause)

Planı değiştirme ve yenileme

Anahtarı nasıl alıp saklayacağınız Genesis API anahtarı rehberinde anlatılır.

Sorular ve cevaplar

Kota erken biterse ne olur?

Kota sıfırlanana kadar sunucu Retry-After ile 429 rate_limited döndürür ve hiçbir şey düşmez. Yeni dönemi bekleyin veya daha yüksek bir plan ödeyin: hemen devreye girer ve kota yenilenir.

304 yanıtları ve hatalar limitlere sayılır mı?

Kotaya sayılmaz: onu yalnızca 200 kullanır. Saniyedeki istek limitine ise sayılır: 304 yanıtları ve hatalar saniyelik pencerede yer kaplar.

Kalan kotayı çağrı harcamadan nasıl görürüm?

Veri yanıtındaki X-Quota-Remaining başlığını okuyun veya /account/usage çağırın: bu istek çağrı harcamaz. Profilinizdeki "Kullanılan çağrı" satırı da kullanımı gösterir.

Birden fazla anahtarla limiti aşabilir miyim?

Hayır. Her hesaba bir anahtar verilir, limitler anahtar başına sayılır ve IP adresini değiştirmek bunları değiştirmez. Limitleri aşmak için birden fazla hesap açmak kuralları ihlal eder; daha fazlası gerekiyorsa daha yüksek bir plana geçin.