Genesis Arbitrage

Genesis Arbitrage · · 3 menit baca

Rate limit

Rate limit membatasi jumlah request yang dapat dikirim klien ke sebuah API per satuan waktu. Jika melewati limit, server menjawab dengan 429 Too Many Requests, yang didefinisikan di RFC 6585, dan dapat menambahkan header Retry-After yang menyebut berapa detik harus menunggu (error HTTP 429).

Rate dan kuota

Biasanya ada dua limit: rate (request per detik atau menit) dan kuota (panggilan per hari atau bulan). Di Genesis API keduanya bergantung pada paket:

PaketRequest per detikPanggilan per 30 hariKuota bertahan pada rate penuh
Trial1500K5,8 hari
Start22M11,6 hari
Pro55M11,6 hari
Max1510M7,7 hari

Kolom terakhir mengasumsikan request tanpa henti pada rate limit dan 200 untuk setiap respons. Untuk Pro: 5 × 86.400 = 432.000 request per hari, dan 5.000.000 / 432.000 ≈ 11,6 hari. Limit per detik adalah batas atas untuk lonjakan, sedangkan kuota menentukan kecepatan rata-rata: 30 hari berisi 2.592.000 detik, jadi Pro bertahan pada rata-rata 5.000.000 / 2.592.000 ≈ 1,93 request per detik.

Hanya respons 200 yang memakai kuota; respons 304 dan error tidak, tetapi tetap dihitung dalam limit request per detik. Volume unduhan dibatasi terpisah sebesar 60 MB data terkompresi per 10 detik per key; yang melebihi batas mendapat 429 download_limited.

Tetap di dalam limit

Setiap respons Genesis API melaporkan status limit di header:

HeaderYang ditunjukkan
X-RateLimit-LimitLimit request per detik untuk paket Anda
X-RateLimit-RemainingSisa request di jendela saat ini
X-RateLimit-ResetWaktu Unix saat jendela direset
Retry-AfterDetik yang perlu ditunggu sebelum mencoba lagi (pada 429 dan 503)

Kuota terlihat di X-Quota-Limit, X-Quota-Remaining, X-Quota-Reset, dan endpoint Penggunaan, /account/usage. Kode di bawah memanggil tiga endpoint berurutan: ketika jendela tidak punya sisa request, kode menunggu X-RateLimit-Reset sendiri, dan pada 429 serta 503 kode berhenti selama Retry-After.

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):
            # server meminta jeda; putaran berikutnya mencoba lagi
            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":
            # jendela habis: tunggu reset-nya, bukan menunggu 429
            reset = int(r.headers.get("X-RateLimit-Reset", "0"))
            time.sleep(max(0.0, reset - time.time()))

while True:
    poll_once()
    time.sleep(10)  # kesegaran Pro: polling lebih sering tidak menambah apa pun

Lihat juga: polling API, kesegaran data, Paket & limit, limit Genesis API, cara polling API tanpa terkena limit.

Tanya jawab

Apa yang terjadi jika kuota bulanan habis?

Request di atas kuota tidak pernah ditagih. Tunggu reset (waktunya ada di X-Quota-Reset) atau pindah ke paket lebih tinggi: paket baru berlaku seketika, kuota mulai dari nol, dan sisa kuota paket lama hangus.

Bisakah saya mengakali limit dengan key kedua?

Tidak. Satu akun memiliki satu key, dan memakai beberapa akun atau rotasi IP untuk melewati limit melanggar aturan. Jika panggilan Anda kurang, kurangi yang tidak perlu dengan filter, parameter coin, dan ETag dengan If-None-Match, atau pindah ke paket lebih tinggi.