Genesis Arbitrage

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

API polling

API polling ताज़ा डेटा पाने का वह तरीका है जिसमें तय अंतराल पर बार-बार अनुरोध भेजे जाते हैं: हर N सेकंड में क्लाइंट सर्वर से पूछता है कि क्या बदला। bot और dashboard REST API के साथ ऐसे ही काम करते हैं, क्योंकि REST अपने-आप कुछ नहीं भेजता: हर poll एक सादा HTTP GET है।

अंतराल और डेटा की ताज़गी

डेटा अपडेट होने से तेज़ poll करने का कोई फ़ायदा नहीं: सर्वर वही snapshot लौटाता है। Genesis API में डेटा की ताज़गी प्लान पर निर्भर है: आउटपुट Trial में हर 60 सेकंड, Start में 30, Pro में 10 और Max में 5 सेकंड पर ताज़ा होता है, और यह मान meta.freshness_sec फ़ील्ड में आता है। snapshot बनने का समय meta.updated_at में है; लगातार दो जवाबों में वही मान हो तो दूसरा अनुरोध बेकार गया।

काल्पनिक उदाहरण: Trial पर एक bot हर 10 सेकंड में एक endpoint poll करता है। मिनट के छह अनुरोधों में से सिर्फ़ एक नया डेटा लाता है; बाक़ी पाँच snapshot दोहराते हैं और कोटा खर्च करते हैं, जब तक bot 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"])
    # प्लान के refresh चरण से तेज़ polling बेकार है
    time.sleep(meta["freshness_sec"])

polling कितने कॉल खर्चती है

एक endpoint को हर 10 सेकंड में poll करना: 2,592,000 ÷ 10 = 30 दिनों में 259,200 कॉल। Genesis API का कोटा भी 30 दिनों का है।

प्लान और कोटाअंतराल = ताज़गीप्रति endpoint कॉलकोटे में समाने वाले endpoint
Trial, 500K60 s43,20011
Start, 2M30 s86,40023
Pro, 5M10 s259,20019
Max, 10M5 s518,40019

यह गणना 304 जवाबों को नहीं गिनती। Pro पर 19 endpoint हर 10 सेकंड में औसतन 1.9 अनुरोध प्रति सेकंड होते हैं, जबकि सीमा 5 है। अनुरोधों को फैलाएँ: एक साथ 19 अनुरोध सीमा पार कर देंगे और सर्वर HTTP 429 से जवाब देगा।

polling, WebSocket और webhook

तरीकाडेटा भेजना कौन शुरू करता हैकिसके लिए ठीक
Pollingक्लाइंट, तय अंतराल परऐसा डेटा जो ज्ञात चरण पर अपडेट होता है; कोई भी HTTP क्लाइंट चलेगा
WebSocketसर्वर, खुले कनेक्शन परबदलावों की लगातार धारा: एक्सचेंज की order book और trades
Webhookसर्वर, आपके URL पर अनुरोध भेजकरदुर्लभ घटनाएँ, अगर आपके पास सार्वजनिक HTTPS endpoint है

Genesis API में न WebSocket है न webhook: डेटा REST से मिलता है और ताज़गी प्लान तय करता है। meta.freshness_sec के अंतराल पर polling इसके साथ काम करने का मानक तरीका है; ट्रैफ़िक और कॉल घटाने के तरीके सीमाओं से टकराए बिना API को poll कैसे करें में हैं।

यह भी देखें: rate limit, दस्तावेज़ में प्लान और लिमिट, रिस्पॉन्स फ़ॉर्मेट, Genesis API की सीमाएँ।

सवाल और जवाब

Genesis API को कितनी बार poll करें?

अपने प्लान के meta.freshness_sec से ज़्यादा बार नहीं: Trial में हर 60 सेकंड, Start में 30, Pro में 10 और Max में 5। इससे तेज़ polling वही डेटा लौटाती है।