Polling API
Polling API adalah cara mendapatkan data terbaru lewat request berulang sesuai jadwal: setiap N detik klien menanyakan ke server apa yang berubah. Bot dan dashboard bekerja seperti ini dengan REST API, yang tidak mengirim apa pun sendiri: setiap polling adalah HTTP GET biasa.
Interval dan kesegaran data
Polling lebih cepat dari pembaruan data tidak ada gunanya: server mengembalikan snapshot yang sama. Di Genesis API, kesegaran data bergantung pada paket: output diperbarui setiap 60 detik di Trial, 30 di Start, 10 di Pro, dan 5 di Max, dan nilai itu datang di field meta.freshness_sec. Waktu pembuatan snapshot ada di meta.updated_at; nilai yang sama di dua respons berturut-turut berarti request kedua sia-sia.
Contoh hipotetis: di Trial, sebuah bot melakukan polling ke satu endpoint setiap 10 detik. Dari enam request per menit hanya satu yang membawa data baru; lima lainnya mengulang snapshot dan tetap memakai kuota kecuali bot mengirim If-None-Match.
import os
import time
import requests
URL = "https://api.genesisarbitrage.com/v1/arbitrage/spot-spot"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}
while True:
r = requests.get(URL, headers=HEADERS,
params={"min_spread": 1}, timeout=10)
if r.status_code in (429, 503):
time.sleep(int(r.headers.get("Retry-After", "5")))
continue
r.raise_for_status()
meta = r.json()["meta"]
print("pairs:", meta["count"], "snapshot:", meta["updated_at"])
# polling lebih cepat dari langkah pembaruan paket tidak ada gunanya
time.sleep(meta["freshness_sec"])
Berapa panggilan yang terpakai
Polling satu endpoint setiap 10 detik: 2.592.000 ÷ 10 = 259.200 panggilan dalam 30 hari. Kuota Genesis API juga mencakup 30 hari.
| Paket dan kuota | Interval = kesegaran | Panggilan per endpoint | Endpoint dalam kuota |
|---|---|---|---|
| Trial, 500K | 60 dtk | 43.200 | 11 |
| Start, 2M | 30 dtk | 86.400 | 23 |
| Pro, 5M | 10 dtk | 259.200 | 19 |
| Max, 10M | 5 dtk | 518.400 | 19 |
Hitungan ini mengabaikan respons 304. Di Pro, 19 endpoint setiap 10 detik rata-rata 1,9 request per detik terhadap limit 5. Sebar request-nya: 19 request sekaligus akan melampaui limit, dan server akan menjawab dengan HTTP 429.
Polling, WebSocket, dan webhook
| Metode | Siapa yang memulai transfer | Cocok untuk |
|---|---|---|
| Polling | Klien, sesuai jadwal | Data yang diperbarui dengan langkah yang diketahui; klien HTTP apa pun cukup |
| WebSocket | Server, lewat koneksi terbuka | Aliran perubahan yang kontinu: order book dan transaksi exchange |
| Webhook | Server, dengan request ke URL Anda | Event yang jarang, jika Anda punya endpoint HTTPS publik |
Genesis API tidak memiliki WebSocket maupun webhook: data disajikan lewat REST, dan paket menentukan kesegarannya. Polling pada meta.freshness_sec adalah cara standar untuk bekerja dengannya; cara mengurangi traffic dan panggilan ada di Cara polling API tanpa terkena limit.
Lihat juga: rate limit, paket dan limit di dokumentasi, format respons, limit Genesis API.
Tanya jawab
Seberapa sering saya harus polling Genesis API?
Tidak lebih sering dari meta.freshness_sec paket Anda: setiap 60 detik di Trial, 30 di Start, 10 di Pro, dan 5 di Max. Polling lebih cepat mengembalikan data yang sama.