Data freshness
Data freshness आप तक पहुँचते समय डेटा की उम्र है: डेटा बनने और आपके पास response आने के बीच कितने सेकंड बीत गए। Crypto Arbitrage में यही तय करता है कि स्प्रेड अभी जीवित है या नहीं: एक मिनट पुराने कोट्स पर बना pair आपके request से पहले बंद हो चुका हो सकता है।
Genesis API के प्लान के अनुसार freshness
Genesis Arbitrage का कोर डेटा हर सेकंड रिफ्रेश करता है, और आपका Genesis API प्लान तय करता है कि API का आउटपुट कितनी बार अपडेट हो। हर response में आपके प्लान का मान meta.freshness_sec में और डेटा बनने का समय meta.updated_at में होता है (response फ़ॉर्मेट)।
| प्लान | freshness_sec | अधिकतम poll दर |
|---|---|---|
| Trial | 60 | हर 60 सेकंड में एक बार |
| Start | 30 | हर 30 सेकंड में एक बार |
| Pro | 10 | हर 10 सेकंड में एक बार |
| Max | 5 | हर 5 सेकंड में एक बार |
freshness_sec से तेज़ poll करने पर वही snapshot मिलता है। पिछले response का ETag If-None-Match में भेजें: अगर कुछ नहीं बदला, तो API बिना body के 304 देता है, और वह response कोटा खर्च नहीं करता (ETag और If-None-Match, API polling)। डेटा दोबारा बनते समय 503 snapshot_not_ready मिलता है; Retry-After सेकंड बाद फिर कोशिश करें।
Order book और venue की उम्र
Order books का अपना समय होता है। /orderbooks/book और /orderbooks/coin/{coin} में हर book के साथ book_ts (book का समय), age_sec (सेकंड में उसकी उम्र) और stale होता है, जो book के 30 सेकंड से पुराना होने पर true होता है। Books एक्सचेंज से 5–20 सेकंड पीछे रहती हैं (market order book)।
age_sec response बनते समय गिना जाता है, इसलिए प्राप्त होने के क्षण now − book_ts ज़्यादा सटीक है। Prediction markets के लिए /predictions/platforms हर venue की freshness दिखाता है: quotes_at उसके ताज़ा कोट्स का समय है और full_scan_at उसके आख़िरी पूरे स्कैन का।
कोड में जाँच
Order books Pro और Max प्लान में हैं, जबकि meta की जाँच हर 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 या rebuild
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"snapshot age {now - meta['updated_at']:.0f} s,"
f" plan freshness {meta['freshness_sec']} s")
book = body["data"]
ts = book["book_ts"]
if book["stale"] or ts is None or now - ts > 30:
print("order book is stale, skipping the signal")
यह भी देखें: Genesis API की सीमाएँ, limits छुए बिना API polling, ऑटोमेशन के जोखिम, order book।
सवाल और जवाब
Freshness और latency में क्या अंतर है?
Latency एक्सचेंज पर घटना से आपके कोड तक का पूरा रास्ता है: एक्सचेंज का उसे प्रकाशित करना, collection, गणना, डिलीवरी और आपका polling अंतराल। Freshness वह हिस्सा है जो आप response में देख सकते हैं: snapshot कितनी देर पहले बना था। सर्वर सेकंड के एक अंश में जवाब दे सकता है और फिर भी एक मिनट पुराना snapshot लौटा सकता है।