Genesis Arbitrage

Genesis Arbitrage · · 3 menit baca

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 kuotaInterval = kesegaranPanggilan per endpointEndpoint dalam kuota
Trial, 500K60 dtk43.20011
Start, 2M30 dtk86.40023
Pro, 5M10 dtk259.20019
Max, 10M5 dtk518.40019

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

MetodeSiapa yang memulai transferCocok untuk
PollingKlien, sesuai jadwalData yang diperbarui dengan langkah yang diketahui; klien HTTP apa pun cukup
WebSocketServer, lewat koneksi terbukaAliran perubahan yang kontinu: order book dan transaksi exchange
WebhookServer, dengan request ke URL AndaEvent 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.