Rate limit
Rate limit, bir istemcinin bir API'ye birim zamanda gönderebileceği istek sayısını sınırlar. Limit aşılınca sunucu, RFC 6585'te tanımlı 429 Too Many Requests ile yanıt verir ve kaç saniye beklenmesi gerektiğini söyleyen bir Retry-After başlığı ekleyebilir (HTTP 429 hatası).
Hız ve kota
Genellikle iki limit vardır: hız (saniyede veya dakikada istek) ve kota (günlük veya aylık çağrı). Genesis API'de ikisi de plana bağlıdır:
| Plan | Saniyedeki istek | 30 günlük çağrı | Tam hızda kota ne kadar yeter |
|---|---|---|---|
| Trial | 1 | 500K | 5,8 gün |
| Start | 2 | 2M | 11,6 gün |
| Pro | 5 | 5M | 11,6 gün |
| Max | 15 | 10M | 7,7 gün |
Son sütun, limit hızında kesintisiz istek yapıldığını ve her yanıtın 200 olduğunu varsayar. Pro için: 5 × 86.400 = 432.000 istek/gün ve 5.000.000 / 432.000 ≈ 11,6 gün. Saniyelik limit ani yüklenmeler için bir tavandır, kota ise ortalama hızı belirler: 30 günde 2.592.000 saniye vardır, yani Pro ortalama 5.000.000 / 2.592.000 ≈ saniyede 1,93 isteği sürdürür.
Yalnızca 200 yanıtları kotayı kullanır; 304 yanıtları ve hatalar kullanmaz, ancak saniyedeki istek limitine yine de sayılır. İndirme hacmi ayrıca sınırlıdır: anahtar başına 10 saniyede 60 MB sıkıştırılmış veri; sınırı aşan istek 429 download_limited alır.
Limit içinde kalmak
Genesis API'nin her yanıtı limit durumunu başlıklarda bildirir:
| Başlık | Ne gösterir |
|---|---|
X-RateLimit-Limit | Planınızın saniyedeki istek limiti |
X-RateLimit-Remaining | Mevcut pencerede kalan istekler |
X-RateLimit-Reset | Pencerenin sıfırlanacağı Unix zamanı |
Retry-After | Tekrar denemeden önce beklenecek saniye (429 ve 503 durumunda) |
Kota, X-Quota-Limit, X-Quota-Remaining, X-Quota-Reset başlıklarında ve Kullanım endpoint'inde, /account/usage adresinde görünür. Aşağıdaki kod üç endpoint'i art arda sorgular: pencerede istek kalmayınca X-RateLimit-Reset zamanını kendisi bekler, 429 ve 503 durumunda ise Retry-After kadar durur.
import os
import time
import requests
BASE = "https://api.genesisarbitrage.com/v1"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}
PATHS = ("/arbitrage/spot-spot", "/funding/spread",
"/market/open-interest")
def poll_once():
for path in PATHS:
r = requests.get(BASE + path, headers=HEADERS, timeout=10)
if r.status_code in (429, 503):
# sunucu ara vermeyi istiyor; sonraki turda yeniden denenir
time.sleep(int(r.headers.get("Retry-After", "1")))
continue
r.raise_for_status()
print(path, "rows:", r.json()["meta"]["count"])
if r.headers.get("X-RateLimit-Remaining") == "0":
# pencere doldu: 429 yerine sıfırlanmasını bekle
reset = int(r.headers.get("X-RateLimit-Reset", "0"))
time.sleep(max(0.0, reset - time.time()))
while True:
poll_once()
time.sleep(10) # Pro tazeliği: daha sık sorgulamak bir şey kazandırmaz
Ayrıca bakın: API polling, veri tazeliği, Planlar ve limitler, Genesis API limitleri, limitlere takılmadan API nasıl sorgulanır.
Sorular ve cevaplar
Aylık kota bitince ne olur?
Kotayı aşan istekler asla ücretlendirilmez. Sıfırlanmayı bekleyin (zaman X-Quota-Reset içindedir) ya da daha yüksek bir plana geçin: yeni plan hemen devreye girer, kota sıfırdan başlar ve eski planın kalan kısmı yanar.
İkinci bir anahtarla limiti aşabilir miyim?
Hayır. Bir hesapta tek anahtar vardır; limiti aşmak için birden fazla hesap kullanmak veya IP değiştirmek kurallara aykırıdır. Çağrılarınız yetmiyorsa gereksizleri filtrelerle, coin parametresiyle ve If-None-Match ile ETag kullanarak azaltın ya da daha yüksek bir plana geçin.