Genesis Arbitrage

Genesis Arbitrage · · 3 dk okuma

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:

PlanSaniyedeki istek30 günlük çağrıTam hızda kota ne kadar yeter
Trial1500K5,8 gün
Start22M11,6 gün
Pro55M11,6 gün
Max1510M7,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ıkNe gösterir
X-RateLimit-LimitPlanınızın saniyedeki istek limiti
X-RateLimit-RemainingMevcut pencerede kalan istekler
X-RateLimit-ResetPencerenin sıfırlanacağı Unix zamanı
Retry-AfterTekrar 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.