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
200yanıtı kullanır.304yanıtları ve hatalar ücretsizdir ama saniyedeki istek limitinde yine de yer kaplar; limit aşılırsa sunucu429döndürür ve hiçbir şey düşmez. meta.freshness_secdeğerinden sık sorgulamak yeni veri getirmez: planınız bu aralıkta bir kez yeni snapshot alır,If-None-Matchise fazladan sorguları ücretsiz304yanı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
| Plan | 30 günde çağrı | Saniyedeki istek | Tazelik |
|---|---|---|---|
| Trial, 20 $/ay | 500.000 | 1 | 60 sn |
| Start, 50 $/ay | 2.000.000 | 2 | 30 sn |
| Pro, 100 $/ay | 5.000.000 | 5 | 10 sn |
| Max, 200 $/ay | 10.000.000 | 15 | 5 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 | Örnek | Ne gösterir |
|---|---|---|
X-RateLimit-Limit | 5 | Planınızın saniyedeki istek limiti |
X-RateLimit-Remaining | 4 | Mevcut pencerede kalan istekler |
X-RateLimit-Reset | 1785200001 | Pencerenin sıfırlanacağı Unix zamanı |
X-Quota-Limit | 5000000 | 30 günlük dönem için çağrı kotası |
X-Quota-Remaining | 4815799 | Dönemde kalan çağrılar |
X-Quota-Reset | 1786492800 | Kotanın sıfırlanacağı Unix zamanı |
Retry-After | 1 | 429 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": { … }
}
| Alan | Tür | Anlamı |
|---|---|---|
plan | string | Plan: trial, start, pro veya max |
calls_used | int | Mevcut dönemde kullanılan çağrılar |
calls_limit | int | Dönem başına çağrı kotası |
rps_limit | int | Saniyedeki istek limiti |
freshness_sec | int | Veri gecikmesi, saniye |
period_resets_at | int | Kotanı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ıt | Ne zaman gelir | Ne yapmalı |
|---|---|---|
429 rate_limited | Saniyede planın izin verdiğinden fazla istek | Retry-After kadar bekleyin, istekleri aralıklandırın |
429 rate_limited | Dönem kotası bitti | Sıfırlanmayı bekleyin veya planı değiştirin |
429 rate_limited | Fonlama analitiğinin tamamı izin verilenden sık indirildi | coin ile dilim alın veya If-None-Match gönderin |
429 download_limited | 10 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
| Plan | Nelere erişilir |
|---|---|
| Trial | CEX 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 |
| Start | Trial'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 Max | Tü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.
- Saniyedeki istek: ortalama 3 / 10 = 0,3. Üçü aynı anda giderse aynı saniyeye düşer, Trial ve Start fazla gelenlere
429döndürür. - Günlük çağrı: 86.400 / 10 = 8.640 sorgu, 8.640 × 3 = 25.920 çağrı.
- 30 günde çağrı: 25.920 × 30 = 777.600. Bu, Trial kotası olan 500.000'den fazladır; Start'ta ise 777.600 / 2.000.000 = kotanın %38,88'i.
- Tazelik: Start'ta snapshot her 30 saniyede güncellenir, yani günde 86.400 / 30 = 2.880 kez. Yeni veri 2.880 × 3 × 30 = 259.200 çağrıdan gelir, kalan 777.600 − 259.200 = 518.400 çağrı aynı şeyi döndürür.
Aynı bot, her planın tazelik aralığında sorgulandığında:
| Tazelik ve sorgu sıklığı | 30 günde çağrı | Plan | Kota payı |
|---|---|---|---|
| Her 60 sn | 129.600 | Trial | %26 |
| Her 30 sn | 259.200 | Start | %13 |
| Her 10 sn | 777.600 | Pro | %16 |
| Her 5 sn | 1.555.200 | Max | %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
- Yeni plan ödemenin hemen ardından devreye girer: yeni limitler ve tazelik gelir, kota sıfırdan başlar, önceki planın kalanı yanar. Site ödemeden önce sizi uyarır.
- Aynı planı yenilemek süreye gün ekler ve kotayı sıfırlamaz: mevcut 30 günlük dönem devam eder.
- Planı değiştirdiğinizde veya yenilediğinizde anahtarınız aynı kalır, programlarınızı güncellemeniz gerekmez.
- Dönem indirimi aylık fiyata uygulanır: Pro için 6 ay 100 $ × 0,8 × 6 = 600 $ yerine 480 $, 3 ay 100 $ × 0,9 × 3 = 270 $.
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.