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, 500K | 60 s | 43,200 | 11 |
| Start, 2M | 30 s | 86,400 | 23 |
| Pro, 5M | 10 s | 259,200 | 19 |
| Max, 10M | 5 s | 518,400 | 19 |
यह गणना 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 वही डेटा लौटाती है।