Genesis API की लिमिट: कॉल कोटा, रिक्वेस्ट प्रति सेकंड, डेटा फ्रेशनेस और 429 एरर
संक्षेप में
- आपका प्लान तय करता है: हर 30 दिन का कॉल कोटा (Trial में 500K से Max में 10M तक), रिक्वेस्ट प्रति सेकंड की लिमिट (1 से 15) और डेटा फ्रेशनेस (60 से 5 सेकंड)।
- कोटा सिर्फ
200रिस्पॉन्स से घटता है।304और एरर मुफ़्त हैं, पर रिक्वेस्ट प्रति सेकंड की लिमिट में एक स्लॉट लेते हैं; लिमिट पार होने पर सर्वर429देता है और कुछ नहीं काटता। meta.freshness_secसे तेज़ पोलिंग से नया डेटा नहीं मिलता: आपके प्लान को हर उतने अंतराल पर एक नया स्नैपशॉट मिलता है, औरIf-None-Matchफ़ालतू पोल को मुफ़्त304में बदल देता है।
Genesis API की लिमिट हर key पर चार सीमाएँ हैं: 30 दिन की अवधि का कॉल कोटा, रिक्वेस्ट प्रति सेकंड की rate limit, डेटा फ्रेशनेस और डाउनलोड की मात्रा। पहली तीन आपका प्लान तय करता है; डाउनलोड की मात्रा सबके लिए समान है: हर 10 सेकंड में 60 MB कंप्रेस्ड डेटा। किसी भी लिमिट के पार जाने पर सर्वर 429 एरर देता है और कुछ नहीं काटता।
प्लान के अनुसार लिमिट
| प्लान | 30 दिन में कॉल | रिक्वेस्ट प्रति सेकंड | फ्रेशनेस |
|---|---|---|---|
| Trial, $20/माह | 500,000 | 1 | 60 सेकंड |
| Start, $50/माह | 2,000,000 | 2 | 30 सेकंड |
| Pro, $100/माह | 5,000,000 | 5 | 10 सेकंड |
| Max, $200/माह | 10,000,000 | 15 | 5 सेकंड |
डेटा फ्रेशनेस वह अंतराल है जिस पर आपके प्लान को नया स्नैपशॉट मिलता है: Trial में हर 60 सेकंड, Max में हर 5। रिस्पॉन्स में यह meta.freshness_sec फ़ील्ड में रहता है। 3 महीने के भुगतान पर 10% और 6 महीने पर 20% की बचत होती है। प्लान की तुलना Genesis API की कीमतें पेज पर है, और नियम डॉक्यूमेंटेशन के प्लान और लिमिट सेक्शन में हैं।
कोटा किससे घटता है
कॉल का मतलब है 200 रिस्पॉन्स। 304 (डेटा नहीं बदला) और 4xx व 5xx एरर कोटा नहीं घटाते, पर रिक्वेस्ट प्रति सेकंड की लिमिट में गिने जाते हैं। /account/usage की रिक्वेस्ट कॉल नहीं खाती।
कोटा 30 दिन की अवधि के लिए है, कैलेंडर महीने के लिए नहीं। रीसेट का समय X-Quota-Reset हेडर, period_resets_at फ़ील्ड और आपकी प्रोफ़ाइल की "resets …" लाइन में मिलता है। कोटा खत्म होने पर सर्वर 429 rate_limited देता है, और Retry-After में रीसेट तक के सेकंड होते हैं, जो कई दिन हो सकते हैं।
rate limit हेडर
डेटा endpoint का रिस्पॉन्स आपकी लिमिट की स्थिति बताता है (उदाहरण के मान):
| हेडर | उदाहरण | क्या दिखाता है |
|---|---|---|
X-RateLimit-Limit | 5 | आपके प्लान की रिक्वेस्ट प्रति सेकंड लिमिट |
X-RateLimit-Remaining | 4 | मौजूदा विंडो में बची रिक्वेस्ट |
X-RateLimit-Reset | 1785200001 | विंडो रीसेट का unix समय |
X-Quota-Limit | 5000000 | 30 दिन की अवधि का कॉल कोटा |
X-Quota-Remaining | 4815799 | अवधि में बची कॉल |
X-Quota-Reset | 1786492800 | कोटा रीसेट का unix समय |
Retry-After | 1 | दोबारा कोशिश से पहले कितने सेकंड रुकना है, 429 और 503 पर |
रिक्वेस्ट प्रति सेकंड की विंडो एक सेकंड की है, इसलिए सामान्य रिस्पॉन्स में X-RateLimit-Reset अगले सेकंड की शुरुआत बताता है। उदाहरण में बचा कोटा: 5,000,000 − 184,201 = 4,815,799 कॉल, वही संख्याएँ जो /account/usage लौटाता है।
/account/usage endpoint
curl "https://api.genesisarbitrage.com/v1/account/usage" \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
"success": true,
"data": {
"plan": "pro",
"calls_used": 184201,
"calls_limit": 5000000,
"rps_limit": 5,
"freshness_sec": 10,
"period_resets_at": 1786492800
},
"meta": { … }
}
| फ़ील्ड | टाइप | मतलब |
|---|---|---|
plan | string | प्लान: trial, start, pro या max |
calls_used | int | मौजूदा अवधि में इस्तेमाल हुई कॉल |
calls_limit | int | प्रति अवधि कॉल कोटा |
rps_limit | int | रिक्वेस्ट प्रति सेकंड की लिमिट |
freshness_sec | int | डेटा की देरी, सेकंड में |
period_resets_at | int | कोटा रीसेट का unix समय |
यह endpoint हर प्लान पर उपलब्ध है और उपयोग सेक्शन में वर्णित है। बॉट शुरू होते समय इसे कॉल करें, ताकि पोलिंग शुरू होने से पहले प्लान और बचा हुआ कोटा जाँच लें।
429 एरर: rate_limited और download_limited
| रिस्पॉन्स | कब आता है | क्या करें |
|---|---|---|
429 rate_limited | प्लान की अनुमति से ज़्यादा रिक्वेस्ट प्रति सेकंड | Retry-After तक रुकें और रिक्वेस्ट के बीच अंतर रखें |
429 rate_limited | अवधि का कोटा खत्म हो गया | रीसेट का इंतज़ार करें या प्लान बदलें |
429 rate_limited | funding analytics का पूरा डाउनलोड अनुमति से जल्दी | coin से स्लाइस लें या If-None-Match भेजें |
429 download_limited | 10 सेकंड में 60 MB से ज़्यादा कंप्रेस्ड डेटा | Retry-After तक रुकें, फ़िल्टर से रिक्वेस्ट छोटी करें |
429 Too Many Requests स्टेटस कोड RFC 6585 में परिभाषित है, जहाँ Retry-After वैकल्पिक है। Genesis API इसे हर 429 के साथ भेजता है, हमेशा सेकंड में।
64 KB से छोटे रिस्पॉन्स डाउनलोड की मात्रा में नहीं गिने जाते, और आपके प्लान की फ्रेशनेस पर सारे डेटा सेट पोल करना लिमिट में आराम से आ जाता है। coin के बिना funding analytics के पूरे डाउनलोड की अपनी लिमिट है: /funding/analytics/summary और /funding/analytics/recent हर 60 सेकंड में एक बार, /funding/analytics/daily हर 300 सेकंड में एक बार प्रति key। coin वाली रिक्वेस्ट और 304 पर कोई लिमिट नहीं है; ब्योरा Funding analytics सेक्शन में है।
प्लान के अनुसार एक्सेस और 403 plan_restricted
| प्लान | क्या खुला है |
|---|---|
| Trial | CEX arbitrage (Spot – Spot, Spot – Futures, Futures – Futures), funding rate और funding spread, Fair – Last, CEX Pumps – Dumps, open interest, AI सिग्नल, कॉइन सर्च, /account/usage |
| Start | Trial का सब कुछ, साथ में स्टॉक /arbitrage/stocks, ऑन-चेन सेक्शन /onchain/{section}, exact और dutch मोड में prediction arbitrage, प्लेटफ़ॉर्म स्टेटस |
| Pro और Max | हर endpoint: DEX – Spot, DEX – Futures, Crosschain, DEX Dumps, order book, funding analytics, prediction market analytics, smart money, ट्रेड, ट्रेडर, llm और sport मोड, DEX स्वैप, OnChain analytics और कॉइन |
प्लान से बाहर का endpoint 403 देता है, और Start पर /predictions/arbitrage को mode=sport की रिक्वेस्ट भी:
{
"success": false,
"error": {
"code": "plan_restricted",
"message": "This endpoint is not included in your plan."
}
}
403 कोटा नहीं घटाता। इसे दोबारा भेजना बेकार है: एक्सेस सिर्फ़ ऊँचा प्लान खोलता है।
अपने लोड के लिए प्लान कैसे चुनें
उदाहरण: एक बॉट तीन endpoint, /arbitrage/spot-spot, /funding/spread और /market/open-interest, हर 10 सेकंड में चौबीसों घंटे पोल करता है।
- रिक्वेस्ट प्रति सेकंड: औसतन 3 / 10 = 0.3। अगर तीनों एक साथ जाएँ तो एक ही सेकंड में आती हैं, और Trial व Start फ़ालतू वालों पर
429लौटाते हैं। - रोज़ की कॉल: 86,400 / 10 = 8,640 पोल, 8,640 × 3 = 25,920 कॉल।
- 30 दिन में कॉल: 25,920 × 30 = 777,600। यह Trial के 500,000 कोटा से ज़्यादा है; Start पर यह 777,600 / 2,000,000 = 38.88% कोटा है।
- फ्रेशनेस: Start पर स्नैपशॉट हर 30 सेकंड में अपडेट होता है, यानी दिन में 86,400 / 30 = 2,880 बार। नया डेटा 2,880 × 3 × 30 = 259,200 कॉल से आता है, और बाकी 777,600 − 259,200 = 518,400 वही चीज़ लौटाती हैं।
वही बॉट हर प्लान की फ्रेशनेस पर पोल करे तो:
| फ्रेशनेस और पोलिंग | 30 दिन में कॉल | प्लान | कोटा का हिस्सा |
|---|---|---|---|
| हर 60 सेकंड | 129,600 | Trial | 26% |
| हर 30 सेकंड | 259,200 | Start | 13% |
| हर 10 सेकंड | 777,600 | Pro | 16% |
| हर 5 सेकंड | 1,555,200 | Max | 16% |
हर 10 सेकंड की पोलिंग Pro से ऊपर ही समझदारी है: 777,600 / 5,000,000 = 15.552% कोटा, और 5 रिक्वेस्ट प्रति सेकंड की लिमिट तीनों को एक साथ भेजने के लिए काफ़ी है। अगर बॉट 30 सेकंड पुराने डेटा से काम चला सकता है, तो हर 30 सेकंड की पोलिंग के साथ Start पर 259,200 / 2,000,000 = 12.96% कोटा लगता है।
बिना बेकार कॉल के पोलिंग: ETag और Retry-After
आपके प्लान को हर meta.freshness_sec सेकंड में नया स्नैपशॉट मिलता है, और तेज़ पोलिंग उसी meta.updated_at के साथ वही स्नैपशॉट लौटाती है। If-None-Match हेडर के बिना ऐसा रिस्पॉन्स 200 और खर्च हुई कॉल है। उसके साथ सर्वर बिना बॉडी के 304 देता है: कोटा नहीं छुआ जाता, पर प्रति सेकंड लिमिट का एक स्लॉट लगता है।
ETag हर रिस्पॉन्स में नहीं आता। यह पूरे डेटा सेट देते हैं, यानी बिना फ़िल्टर की रिक्वेस्ट, जैसे नीचे के उदाहरण में /funding/spread। फ़िल्टर किए रिस्पॉन्स (coin, min_spread आदि) में ETag नहीं होता और हर पोल एक कॉल खर्च करता है: फ़िल्टर ट्रैफ़िक बचाते हैं, ETag कोटा। रीट्राई और कंप्रेशन API को कुशलता से कैसे पोल करें में और रिस्पॉन्स और एरर गाइड में हैं।
import os
import time
import requests
URL = "https://api.genesisarbitrage.com/v1/funding/spread"
KEY = os.environ["GENESIS_API_KEY"]
etag, pause = None, 30
while True:
headers = {"X-API-Key": KEY}
if etag:
headers["If-None-Match"] = etag
r = requests.get(URL, headers=headers, timeout=15)
if r.status_code in (429, 500, 503):
wait = int(r.headers.get("Retry-After", "5"))
if wait > 600: # कोटा खत्म है, यहीं रुकते हैं
raise SystemExit(f"Quota used up, resets in {wait} s")
time.sleep(wait)
continue
r.raise_for_status() # दोबारा कोशिश से 401 या 403 ठीक नहीं होगा
left = r.headers.get("X-Quota-Remaining") # हो सकता है न हो
if left is not None and int(left) < 10_000:
print("Quota running low:", left)
if r.status_code == 200: # 304 पर डेटा नहीं बदला है
etag = r.headers.get("ETag")
body = r.json()
pause = body["meta"].get("freshness_sec", pause)
print(body["meta"]["count"], "coins in the response")
time.sleep(pause)
प्लान बदलना और रिन्यू करना
- नया प्लान भुगतान के तुरंत बाद लागू होता है: नई लिमिट और फ्रेशनेस, कोटा शून्य से शुरू होता है, और पिछले प्लान का बचा हिस्सा चला जाता है। भुगतान से पहले साइट आपको चेतावनी देती है।
- वही प्लान रिन्यू करने से अवधि में दिन जुड़ते हैं और कोटा रीसेट नहीं होता: मौजूदा 30 दिन की अवधि चलती रहती है।
- प्लान बदलने या रिन्यू करने पर आपकी key वही रहती है, इसलिए आपके प्रोग्राम अपडेट करने की ज़रूरत नहीं।
- अवधि की छूट मासिक कीमत पर लगती है: Pro 6 महीने के लिए $100 × 0.8 × 6 = $480 है, $600 की जगह, और 3 महीने के लिए $100 × 0.9 × 3 = $270।
key कैसे पाएँ और सुरक्षित रखें, यह Genesis API key गाइड में है।
सवाल और जवाब
कोटा जल्दी खत्म हो जाए तो क्या होता है?
कोटा रीसेट होने तक सर्वर Retry-After के साथ 429 rate_limited देता है, और कुछ नहीं कटता। नई अवधि का इंतज़ार करें या ऊँचे प्लान का भुगतान करें: वह तुरंत लागू होता है, नए कोटा के साथ।
क्या 304 और एरर लिमिट में गिने जाते हैं?
कोटा में नहीं: उसे सिर्फ़ 200 घटाता है। पर रिक्वेस्ट प्रति सेकंड की लिमिट में गिने जाते हैं: 304 और एरर प्रति सेकंड विंडो में स्लॉट लेते हैं।
कॉल खर्च किए बिना बचा कोटा कैसे देखूँ?
डेटा रिस्पॉन्स में X-Quota-Remaining पढ़ें या /account/usage कॉल करें: यह रिक्वेस्ट कॉल नहीं खाती। प्रोफ़ाइल की "Calls used" लाइन भी उपयोग दिखाती है।
क्या कई key से लिमिट को टाला जा सकता है?
नहीं। हर अकाउंट को एक key मिलती है, लिमिट प्रति key गिनी जाती हैं, और IP बदलने से वे नहीं बदलतीं। लिमिट से बचने के लिए कई अकाउंट खोलना नियमों का उल्लंघन है; ज़्यादा चाहिए तो ऊँचे प्लान पर जाएँ।