Kesegaran data
Kesegaran data (data freshness) adalah usia data pada saat sampai ke Anda: berapa detik berlalu antara data dibuat dan respons tiba. Dalam arbitrase, ini menentukan apakah sebuah spread masih ada: pasangan yang dihitung dari harga semenit lalu bisa saja sudah tertutup sebelum permintaan Anda tiba.
Kesegaran menurut paket Genesis API
Inti Genesis Arbitrage memperbarui data setiap detik, sedangkan paket Genesis API Anda menentukan seberapa sering output API diperbarui. Setiap respons membawa nilai paket Anda di meta.freshness_sec dan waktu pembuatan data di meta.updated_at (format respons).
| Paket | freshness_sec | Polling maksimal |
|---|---|---|
| Trial | 60 | sekali per 60 dtk |
| Start | 30 | sekali per 30 dtk |
| Pro | 10 | sekali per 10 dtk |
| Max | 5 | sekali per 5 dtk |
Polling lebih sering dari freshness_sec hanya mengembalikan snapshot yang sama. Kirim ETag dari respons sebelumnya di header If-None-Match: jika tidak ada yang berubah, API menjawab 304 tanpa body, dan respons itu tidak memakai kuota (ETag dan If-None-Match, polling API). Saat data sedang dibangun ulang Anda menerima 503 snapshot_not_ready; coba lagi setelah Retry-After detik.
Order book dan usia di tiap exchange
Order book punya waktunya sendiri. Di /orderbooks/book dan /orderbooks/coin/{coin}, setiap book memiliki book_ts (waktu book), age_sec (usianya dalam detik) dan stale, yang bernilai true bila book lebih tua dari 30 dtk. Book tertinggal 5–20 detik dari exchange (order book pasar).
age_sec dihitung saat respons dibuat, jadi pada saat diterima now − book_ts lebih akurat. Untuk pasar prediksi, /predictions/platforms menampilkan kesegaran per platform: quotes_at adalah waktu kuotasi terbarunya dan full_scan_at waktu pemindaian penuh terakhirnya.
Pengecekan lewat kode
Order book tersedia di paket Pro dan Max, sedangkan pengecekan meta sama untuk setiap endpoint.
import os
import time
import requests
URL = "https://api.genesisarbitrage.com/v1/orderbooks/book"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}
def get_json(params, tries=3):
for _ in range(tries):
r = requests.get(URL, headers=HEADERS, params=params,
timeout=10)
if r.status_code in (429, 503): # rate limit atau pembangunan ulang
time.sleep(int(r.headers.get("Retry-After", "5")))
continue
r.raise_for_status()
return r.json()
raise RuntimeError("data not ready")
params = {"exchange": "Binance", "market": "spot", "coin": "BTC"}
body = get_json(params)
now = time.time()
meta = body["meta"]
print(f"usia snapshot {now - meta['updated_at']:.0f} dtk,"
f" kesegaran paket {meta['freshness_sec']} dtk")
book = body["data"]
ts = book["book_ts"]
if book["stale"] or ts is None or now - ts > 30:
print("order book basi, sinyal dilewati")
Lihat juga: batas Genesis API, polling API tanpa kena limit, risiko otomatisasi, order book.
Tanya jawab
Apa bedanya kesegaran dengan latensi?
Latensi adalah seluruh jalur dari peristiwa di exchange sampai ke kode Anda: exchange menerbitkannya, pengumpulan, perhitungan, pengiriman, dan interval polling Anda. Kesegaran adalah bagian yang bisa Anda lihat di respons: sudah berapa lama snapshot dibuat. Server bisa menjawab dalam sepersekian detik namun tetap mengembalikan snapshot berusia semenit.