Genesis API क्विकस्टार्ट: कुंजी, पहली रिक्वेस्ट और सीमाएँ
संक्षेप में
- Genesis API, Genesis Arbitrage के डेटा तक REST एक्सेस है: CEX और DEX स्प्रेड, ऑर्डर बुक, फंडिंग, क्रॉसचेन, ऑन-चेन फ़्लो, प्रेडिक्शन मार्केट और Genesis AI+ सिग्नल।
- पहली रिक्वेस्ट तक तीन कदम हैं: प्लान, प्रोफ़ाइल में कुंजी, और X-API-Key हेडर के साथ GET रिक्वेस्ट।
- आपका प्लान कॉल का कोटा, प्रति सेकंड रिक्वेस्ट और डेटा की देरी तय करता है — Trial पर 60 सेकंड से Max पर 5 सेकंड तक।
Genesis API, Genesis Arbitrage का डेटा REST API के रूप में देती है: CEX और DEX के बीच स्प्रेड, ऑर्डर बुक, फंडिंग, क्रॉसचेन, ऑन-चेन फ़्लो, प्रेडिक्शन मार्केट और Genesis AI+ सिग्नल। साइट का हर टूल एक ही JSON प्रारूप में अपना अलग एंडपॉइंट है। पहली रिक्वेस्ट के लिए एक API प्लान, एक कुंजी और एक HTTP हेडर चाहिए — SDK की ज़रूरत नहीं, HTTP क्लाइंट वाली कोई भी भाषा चलेगी।

API क्या कवर करती है
एंडपॉइंट साइट के सेक्शन जैसे ही हैं:
- आर्बिट्रेज — Spot – Spot, Spot – Futures, Futures – Futures, DEX – Spot, DEX – Futures, क्रॉसचेन और स्टॉक आर्बिट्रेज।
- ऑर्डर बुक — हर बाज़ार पर किसी मात्रा के लिए एक्ज़ीक्यूशन कीमतें, आर्बिट्रेज पंक्तियों के लिए «ऑर्डर बुक Δ», बाज़ार की ऑर्डर बुक, एक्ज़ीक्यूशन का इतिहास और DEX स्लिपेज (API Pro और Max प्लान पर)।
- प्रेडिक्शन मार्केट — प्रेडिक्शन आर्बिट्रेज और प्लेटफ़ॉर्म की स्थिति; एनालिटिक्स, स्मार्ट मनी, बड़े ट्रेड और ट्रेडरों की रैंकिंग — API Pro और Max प्लान पर।
- फंडिंग — सभी एक्सचेंजों की फंडिंग दरें, फंडिंग स्प्रेड और फंडिंग का ऐतिहासिक एनालिटिक्स (API Pro और Max प्लान पर)।
- बाज़ार — Fair – Last, CEX पंप्स – डंप्स, DEX डंप्स, OI ट्रैकिंग।
- ऑन-चेन — बड़े ट्रांसफ़र, CEX फ़्लो, मिंट और ब्रिज, टीम वॉलेट, Perp. DEX पोज़िशन, अनलॉक, क्लेम, हैक; API Pro और Max प्लान पर DEX ओवरव्यू, एनालिटिक्स और सिक्के का पेज भी।
- AI और खोज — Genesis AI+ सिग्नल और सिक्के का पूरा कार्ड।
- खाता — आपकी कुंजी की स्थिति: प्लान, इस्तेमाल हुआ कोटा और सीमाएँ।
डेटा सेट Genesis API पेज पर वर्णित हैं; हर एंडपॉइंट के पैरामीटर और फ़ील्ड डॉक्यूमेंटेशन में हैं।
प्लान और सीमाएँ
API के अपने प्लान हैं, जो साइट की सदस्यता से अलग हैं: Trial, Start, Pro और Max। वे कॉल के कोटा, प्रति सेकंड रिक्वेस्ट की सीमा और डेटा की ताज़गी में अलग हैं।
| API प्लान | प्रति माह कॉल | डेटा की ताज़गी |
|---|---|---|
| Trial | 500K | 60 सेकंड |
| Start | 2M | 30 सेकंड |
| Pro | 5M | 10 सेकंड |
| Max | 10M | 5 सेकंड |
Trial की कीमत $20 प्रति माह है, और Max में प्रति सेकंड 15 रिक्वेस्ट की अनुमति है। जो एंडपॉइंट आपके प्लान में नहीं हैं, वे plan_restricted कोड के साथ 403 त्रुटि लौटाते हैं। सीमा से ऊपर की रिक्वेस्ट के पैसे नहीं लगते: नई अवधि का इंतज़ार करें या अपग्रेड करें। कोटा सिर्फ़ 200 रिस्पॉन्स खर्च करते हैं: त्रुटियाँ और 304 रिस्पॉन्स मुफ़्त हैं। कीमतें और पूरी तुलना Genesis API की कीमतें पेज पर हैं।
आपकी पहली रिक्वेस्ट
प्लान चुनें
Genesis API की कीमतें पेज पर प्लान और अवधि चुनें और «सब्सक्राइब करें» दबाएँ। भुगतान क्रिप्टो में होता है, ठीक साइट की सदस्यता की तरह। अगर कोई दूसरा API प्लान पहले से सक्रिय है, तो नए का भुगतान उसे बदल देता है और बचा हुआ हिस्सा समाप्त हो जाता है — साइट पहले इसकी चेतावनी देती है।
अपनी कुंजी लें
प्रोफ़ाइल में, Genesis API ब्लॉक में, «कुंजी लें» दबाएँ। «आपकी API कुंजी» विंडो में
gns_live_…कुंजी दिखती है — «कॉपी» दबाएँ और उसे सहेज लें। वह सिर्फ़ एक बार दिखती है।रिक्वेस्ट भेजें
सामान्य HTTP GET भेजें और कुंजी
X-API-Keyहेडर में दें। बेस URLhttps://api.genesisarbitrage.com/v1है। पहला अच्छा एंडपॉइंट/account/usageहै — वह आपका प्लान और बचा हुआ कोटा दिखाता है।रिस्पॉन्स पार्स करें
सफल रिस्पॉन्स एक ही लिफ़ाफ़े में आता है:
dataऐरे औरmetaब्लॉक। अगर कुछ गड़बड़ हो, तो नीचे की त्रुटि तालिका देखें।
curl का उदाहरण:
curl "https://api.genesisarbitrage.com/v1/account/usage" \
-H "X-API-Key: gns_live_…"
डॉक्यूमेंटेशन में «आज़माएं» फ़ॉर्म है: अपनी कुंजी चिपकाएँ, «रिक्वेस्ट भेजें» दबाएँ और पेज पर ही संक्षिप्त रिस्पॉन्स देखें। कुंजी सिर्फ़ आपके ब्राउज़र में रहती है।
रिस्पॉन्स का प्रारूप
dataमें एंडपॉइंट के अनुसार ऐरे या ऑब्जेक्ट होता है।metaमें तत्वों की संख्या, डेटा के आख़िरी अपडेट का समय, आपके प्लान की देरी सेकंड में और आपका प्लान होता है।- खाली मान
nullहैं। समय unix सेकंड में हैं। - स्प्रेड और दरें प्रतिशत में हैं: 0.92 का मतलब 0.92%।
- सभी फ़िल्टर पैरामीटर वैकल्पिक हैं: उनके बिना एंडपॉइंट पूरा डेटा सेट लौटाता है।
त्रुटियाँ और सीमाएँ
| कोड | मतलब |
|---|---|
| 401 | कुंजी अनुपस्थित, अमान्य या रद्द है |
| 403 | एंडपॉइंट आपके प्लान में नहीं है |
| 404 | एंडपॉइंट या संसाधन नहीं मिला |
| 429 | सीमा पार हो गई — X-RateLimit और Retry-After हेडर देखें |
| 500 | आंतरिक त्रुटि, बाद में दोबारा कोशिश करें |
| 503 | डेटा फिर से बन रहा है, कुछ सेकंड बाद दोबारा कोशिश करें — Retry-After देखें |
हर रिस्पॉन्स के X-RateLimit हेडर आपकी प्रति सेकंड रिक्वेस्ट की सीमा, मौजूदा विंडो में बची रिक्वेस्ट और विंडो के रीसेट होने का समय दिखाते हैं। X-Quota हेडर अवधि के लिए कॉल का कोटा, उसका बचा हुआ हिस्सा और रीसेट होने का समय दिखाते हैं। हर रिस्पॉन्स में X-Request-Id भी होता है: सहायता से संपर्क करते समय उसे रिक्वेस्ट के UTC समय, एंडपॉइंट और स्टेटस के साथ दें। कुंजी खुद कभी न भेजें।
आगे क्या
- API key: पाना, सहेजना, दोबारा जारी करना — key प्रोफ़ाइल में कहाँ रहती है और उसे सुरक्षित कैसे रखें।
- लिमिट: कोटा, प्रति सेकंड रिक्वेस्ट, ताज़गी — 429 रिस्पॉन्स से कैसे बचें।
- रिस्पॉन्स और एरर: JSON, ETag, HTTP कोड — रिस्पॉन्स एनवेलप, 304 और रीट्राई।
- ग्रुप के अनुसार endpoint: आर्बिट्राज, order book, funding, मार्केट और AI सिग्नल, ऑन-चेन, प्रेडिक्शन मार्केट और surebets।
- AI एजेंट के लिए Genesis API — OpenAPI स्पेक, llms.txt और function calling।
सवाल और जवाब
Genesis API मुफ़्त एक्सचेंज API से कैसे अलग है?
एक्सचेंज API एक प्लेटफ़ॉर्म की ऑर्डर बुक और टिकर लौटाती हैं। Genesis API दर्जनों एक्सचेंज और नेटवर्क के बीच गणना किए हुए स्प्रेड, जमा और निकासी के फ़्लैग, और कम लिक्विडिटी वाले पेयर से साफ़ किया हुआ डेटा लौटाती है।
अगर मैं सीमा पार कर दूँ तो क्या होगा?
सर्वर X-RateLimit और Retry-After हेडर के साथ 429 लौटाता है। अतिरिक्त रिक्वेस्ट के पैसे नहीं लगते।
क्या मैं अपना API प्लान बदल सकता हूँ?
हाँ। नया प्लान भुगतान के तुरंत बाद लागू हो जाता है: नई सीमाएँ और ताज़गी तुरंत लगती हैं, कॉल का कोटा शून्य से गिना जाता है, और पिछले प्लान का बचा हुआ हिस्सा समाप्त हो जाता है। उसी प्लान का नवीनीकरण मौजूदा अवधि में दिन जोड़ता है।
क्या मैं डेटा अपने उत्पाद में इस्तेमाल कर सकता हूँ?
हाँ, आप Genesis API पर अपनी सेवाएँ, बॉट और डैशबोर्ड बना सकते हैं। कच्चे डेटा को जस का तस दोबारा बेचने की अनुमति नहीं है।