Genesis Arbitrage

Genesis Arbitrage · · 3 मिनट में पढ़ें

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 दर
Trial60हर 60 सेकंड में एक बार
Start30हर 30 सेकंड में एक बार
Pro10हर 10 सेकंड में एक बार
Max5हर 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 लौटा सकता है।