Genesis Arbitrage

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

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,000160 सेकंड
Start, $50/माह2,000,000230 सेकंड
Pro, $100/माह5,000,000510 सेकंड
Max, $200/माह10,000,000155 सेकंड

डेटा फ्रेशनेस वह अंतराल है जिस पर आपके प्लान को नया स्नैपशॉट मिलता है: 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-Limit5आपके प्लान की रिक्वेस्ट प्रति सेकंड लिमिट
X-RateLimit-Remaining4मौजूदा विंडो में बची रिक्वेस्ट
X-RateLimit-Reset1785200001विंडो रीसेट का unix समय
X-Quota-Limit500000030 दिन की अवधि का कॉल कोटा
X-Quota-Remaining4815799अवधि में बची कॉल
X-Quota-Reset1786492800कोटा रीसेट का unix समय
Retry-After1दोबारा कोशिश से पहले कितने सेकंड रुकना है, 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": { … }
}
फ़ील्डटाइपमतलब
planstringप्लान: trial, start, pro या max
calls_usedintमौजूदा अवधि में इस्तेमाल हुई कॉल
calls_limitintप्रति अवधि कॉल कोटा
rps_limitintरिक्वेस्ट प्रति सेकंड की लिमिट
freshness_secintडेटा की देरी, सेकंड में
period_resets_atintकोटा रीसेट का unix समय

यह endpoint हर प्लान पर उपलब्ध है और उपयोग सेक्शन में वर्णित है। बॉट शुरू होते समय इसे कॉल करें, ताकि पोलिंग शुरू होने से पहले प्लान और बचा हुआ कोटा जाँच लें।

429 एरर: rate_limited और download_limited

रिस्पॉन्सकब आता हैक्या करें
429 rate_limitedप्लान की अनुमति से ज़्यादा रिक्वेस्ट प्रति सेकंडRetry-After तक रुकें और रिक्वेस्ट के बीच अंतर रखें
429 rate_limitedअवधि का कोटा खत्म हो गयारीसेट का इंतज़ार करें या प्लान बदलें
429 rate_limitedfunding analytics का पूरा डाउनलोड अनुमति से जल्दीcoin से स्लाइस लें या If-None-Match भेजें
429 download_limited10 सेकंड में 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

प्लानक्या खुला है
TrialCEX arbitrage (Spot – Spot, Spot – Futures, Futures – Futures), funding rate और funding spread, Fair – Last, CEX Pumps – Dumps, open interest, AI सिग्नल, कॉइन सर्च, /account/usage
StartTrial का सब कुछ, साथ में स्टॉक /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 सेकंड में चौबीसों घंटे पोल करता है।

वही बॉट हर प्लान की फ्रेशनेस पर पोल करे तो:

फ्रेशनेस और पोलिंग30 दिन में कॉलप्लानकोटा का हिस्सा
हर 60 सेकंड129,600Trial26%
हर 30 सेकंड259,200Start13%
हर 10 सेकंड777,600Pro16%
हर 5 सेकंड1,555,200Max16%

हर 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)

प्लान बदलना और रिन्यू करना

key कैसे पाएँ और सुरक्षित रखें, यह Genesis API key गाइड में है।

सवाल और जवाब

कोटा जल्दी खत्म हो जाए तो क्या होता है?

कोटा रीसेट होने तक सर्वर Retry-After के साथ 429 rate_limited देता है, और कुछ नहीं कटता। नई अवधि का इंतज़ार करें या ऊँचे प्लान का भुगतान करें: वह तुरंत लागू होता है, नए कोटा के साथ।

क्या 304 और एरर लिमिट में गिने जाते हैं?

कोटा में नहीं: उसे सिर्फ़ 200 घटाता है। पर रिक्वेस्ट प्रति सेकंड की लिमिट में गिने जाते हैं: 304 और एरर प्रति सेकंड विंडो में स्लॉट लेते हैं।

कॉल खर्च किए बिना बचा कोटा कैसे देखूँ?

डेटा रिस्पॉन्स में X-Quota-Remaining पढ़ें या /account/usage कॉल करें: यह रिक्वेस्ट कॉल नहीं खाती। प्रोफ़ाइल की "Calls used" लाइन भी उपयोग दिखाती है।

क्या कई key से लिमिट को टाला जा सकता है?

नहीं। हर अकाउंट को एक key मिलती है, लिमिट प्रति key गिनी जाती हैं, और IP बदलने से वे नहीं बदलतीं। लिमिट से बचने के लिए कई अकाउंट खोलना नियमों का उल्लंघन है; ज़्यादा चाहिए तो ऊँचे प्लान पर जाएँ।