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:
| Paket | Request per detik | Panggilan per 30 hari | Kuota bertahan pada rate penuh |
|---|---|---|---|
| Trial | 1 | 500K | 5,8 hari |
| Start | 2 | 2M | 11,6 hari |
| Pro | 5 | 5M | 11,6 hari |
| Max | 15 | 10M | 7,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:
| Header | Yang ditunjukkan |
|---|---|
X-RateLimit-Limit | Limit request per detik untuk paket Anda |
X-RateLimit-Remaining | Sisa request di jendela saat ini |
X-RateLimit-Reset | Waktu Unix saat jendela direset |
Retry-After | Detik 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.