Crypto API क्या है और क्या ऑटोमेट किया जा सकता है
संक्षेप में
- Crypto API एक प्रोग्रामिंग इंटरफ़ेस है, जिससे आपका प्रोग्राम मार्केट डेटा मांगता है और JSON रिस्पॉन्स पाता है: साइट की टेबल वाला वही स्प्रेड,
exchange_buy,exchange_sellऔरspread_pctफ़ील्ड के रूप में। - एक्सचेंज API एक प्लेटफ़ॉर्म का डेटा और अकाउंट संभालती है, मार्केट डेटा API कई एक्सचेंज को एक फ़ॉर्मेट में जोड़ती है, और on-chain API ब्लॉकचेन पढ़ती है। Genesis API सिर्फ़ पढ़ने वाली मार्केट डेटा API है।
- API से ट्रेडर स्प्रेड, funding rate और open interest की निगरानी, अलर्ट, सिग्नल लॉग, डैशबोर्ड और ऐतिहासिक रिसर्च ऑटोमेट करते हैं।
- अनुभव के बिना ट्रेड का एक्ज़ीक्यूशन और निकासी हाथ से ही रखें: डेटा स्नैपशॉट एक्सचेंज से पीछे रहते हैं, और आपके कोड की गलती हर चक्र में दोहराई जाती है।
Crypto API एक प्रोग्रामिंग इंटरफ़ेस है, जिससे आपका कोड क्रिप्टो मार्केट का डेटा मांगता है और ऐसा जवाब पाता है जिस पर वह काम कर सके: कीमतें, एक्सचेंजों के बीच स्प्रेड, funding rate, open interest। इंसान ये संख्याएँ टेबल में पढ़ता है; प्रोग्राम इन्हें JSON फ़ील्ड के रूप में पाता है और तुरंत थ्रेशोल्ड से मिला सकता है, लॉग कर सकता है या अलर्ट भेज सकता है। सामान्य परिभाषा शब्दकोश की प्रविष्टि API में है।
रिक्वेस्ट और रिस्पॉन्स
API के साथ काम दो संदेशों का आदान-प्रदान है: आपका प्रोग्राम किसी पते पर रिक्वेस्ट भेजता है, और सर्वर रिस्पॉन्स लौटाता है। सबसे छोटा उदाहरण Genesis API की स्टेटस जाँच है, जिसमें कुंजी नहीं लगती:
curl "https://api.genesisarbitrage.com/health"
{"ok":true}
curl HTTP रिक्वेस्ट के लिए कमांड-लाइन प्रोग्राम है; curl --version बताता है कि वह इंस्टॉल है या नहीं। डेटा रिक्वेस्ट के लिए API key चाहिए, यानी एक स्ट्रिंग जिससे सर्वर आपका अकाउंट और प्लान पहचानता है। एक उदाहरण: FUEL कॉइन के लिए Spot – Spot जोड़ियाँ, कुंजी GENESIS_API_KEY एनवायरनमेंट वेरिएबल से ली गई है:
URL="https://api.genesisarbitrage.com/v1/arbitrage/spot-spot"
curl "$URL?coin=FUEL" -H "X-API-Key: $GENESIS_API_KEY"
{
"success": true,
"data": [
{
"coin": "FUEL",
"exchange_buy": "ByBit",
"exchange_sell": "Gate",
"price_buy": 0.0007029,
"price_sell": 0.0007037,
"spread_pct": 0.11,
"withdraw_enabled_buy": true,
"deposit_enabled_sell": true,
…
}
],
"meta": {
"count": 1,
"updated_at": 1794675861,
"freshness_sec": 60,
"plan": "trial"
}
}
रिस्पॉन्स में एक जोड़ी है: FUEL को ByBit पर 0.0007029 में खरीदना और Gate पर 0.0007037 में बेचना। स्प्रेड spread_pct में पहले से निकला हुआ है: (0.0007037 − 0.0007029) / 0.0007029 × 100 ≈ 0.11%। withdraw_enabled_buy और deposit_enabled_sell फ़्लैग दिखाते हैं कि ByBit से निकासी और Gate पर जमा खुले हैं, और meta.updated_at बताता है कि स्नैपशॉट कब बना। Spot – Spot टेबल यही संख्याएँ दिखाती है, और हर फ़ील्ड का वर्णन डॉक्स के Spot — Spot सेक्शन में है।
रिक्वेस्ट का पता बेस URL, endpoint पाथ और पैरामीटर से बनता है, जबकि कुंजी अलग से X-API-Key हेडर में जाती है। पाठ 2 रिक्वेस्ट के हर हिस्से को खोलकर समझाता है, स्टेटस कोड और JSON पढ़ना बताता है, और दिखाता है कि कुंजी का वेरिएबल कैसे सेट करें।
इस तरह का आदान-प्रदान, यानी रिक्वेस्ट और फिर डेटा के स्नैपशॉट वाला रिस्पॉन्स, REST API कहलाता है। नया डेटा रिक्वेस्ट दोबारा भेजकर मिलता है: Genesis API अपना आउटपुट हर meta.freshness_sec सेकंड में ताज़ा करती है, Trial में 60 से Max में 5 तक। एक्सचेंज एक दूसरा चैनल भी देते हैं, WebSocket: कनेक्शन खुला रहता है और सर्वर ट्रेड और order book के बदलाव होते ही भेज देता है, जैसे Binance streams में। Genesis API में WebSocket नहीं है।
Crypto API के प्रकार
Crypto API इस बात में अलग हैं कि डेटा कहाँ से आता है और उनके ज़रिए क्या किया जा सकता है:
- एक्सचेंज API: एक प्लेटफ़ॉर्म का डेटा और अकाउंट एक्सेस। एक्सचेंज कीमतें, order book और ट्रेड सार्वजनिक रूप से देता है, जबकि बैलेंस, ऑर्डर और ट्रेड इतिहास के लिए कुंजी और साइन किया हुआ रिक्वेस्ट चाहिए। Binance इसे सुरक्षा प्रकारों में बताता है: खुले मार्केट डेटा के लिए
NONE, ऑर्डर लगाने और रद्द करने के लिएTRADE, अकाउंट विवरण के लिएUSER_DATA(Binance डॉक्स)। - मार्केट डेटा API: कई एक्सचेंज और नेटवर्क एक फ़ॉर्मेट में। यह वह देती है जिसके लिए प्लेटफ़ॉर्म जोड़ने पड़ते हैं: एक्सचेंजों के बीच स्प्रेड, एक अवधि पर सामान्यीकृत funding rate, एक्सचेंज के हिसाब से open interest। Genesis API इसी प्रकार की है, और यह सिर्फ़ डेटा पढ़ती है।
- On-chain API: ब्लॉकचेन का डेटा, जैसे ट्रांज़ैक्शन, टोकन ट्रांसफ़र और पतों के बैलेंस। «एक्सचेंज», «प्रोजेक्ट टीम» या «व्हेल» जैसे लेबल नेटवर्क डेटा के ऊपर बनी एनालिटिक्स सेवाओं से आते हैं।
छह प्रकार की API की तुलना, REST बनाम WebSocket और चुनने की नौ-बिंदु वाली चेकलिस्ट ओवरव्यू Crypto API के प्रकार और कैसे चुनें में है।
ट्रेडर क्या ऑटोमेट कर सकता है
वह ऑटोमेट करें जिसे आप तय नियम से दोहराते हैं: टेबल खोलना, संख्या को थ्रेशोल्ड से मिलाना, नतीजा लिख लेना। प्रोग्राम यह शेड्यूल पर करता है और रात के घंटे नहीं छोड़ता।
| काम | प्रोग्राम क्या करता है | Genesis API डेटा |
|---|---|---|
| स्प्रेड निगरानी | थ्रेशोल्ड से ऊपर की जोड़ियाँ, जिनमें जमा और निकासी खुली हों | /arbitrage/spot-spot, /arbitrage/spot-futures |
| Funding | 8 घंटे पर सामान्यीकृत एक्सचेंज रेट की तुलना करता है | /funding/rates, /funding/spread |
| Open interest | 5 मिनट से 1 घंटे में OI के तेज़ बदलाव पकड़ता है | /market/open-interest |
| अलर्ट | शर्त पूरी होने पर Telegram में संदेश भेजता है | कोई भी डेटा endpoint |
| लॉग | मिली हर जोड़ी को समय के साथ सहेजता है | रिस्पॉन्स और meta.updated_at |
| डैशबोर्ड | आपके कॉलम और थ्रेशोल्ड आपके अपने पेज पर दिखाता है | आपके सर्वर से रिक्वेस्ट |
| ऐतिहासिक रिसर्च | पिछले डेटा में पैटर्न खोजता है | /funding/analytics/daily (Pro, Max) |
अलर्ट अक्सर पहला प्रोजेक्ट होता है: प्रोग्राम endpoint को meta.freshness_sec से ज़्यादा बार नहीं पूछता और स्प्रेड या रेट आपके थ्रेशोल्ड को पार करे तो संदेश भेजता है। बिना कोड के, ऐसे ही सिग्नल साइट के Pro प्लान में Genesis Arbitrage के Telegram अलर्ट से मिलते हैं।
लॉग किसी विचार को पैसा लगाने से पहले परखता है। एक उदाहरण: बॉट हर 30 सेकंड में 1% या उससे ज़्यादा स्प्रेड वाली जोड़ियाँ दर्ज करता है, यानी दिन में 86,400 / 30 = 2,880 स्नैपशॉट। इनसे पता चलता है कि कितनी जोड़ियाँ एक मिनट से ज़्यादा टिकीं और कितनी अगली पोलिंग तक गायब हो गईं।
इतिहास के लिए Genesis API funding analytics देती है, यानी 13 एक्सचेंज में एक साल तक के दैनिक settled-funding योग, और order book की slippage history; दोनों Pro और Max प्लान में हैं। Genesis API में ऐतिहासिक कैंडल नहीं हैं: वे एक्सचेंज API देती हैं, Binance पर GET /api/v3/klines से हर रिक्वेस्ट में 1,000 कैंडल तक (Binance डॉक्स)। एक्सचेंजों के बीच स्प्रेड का इतिहास आपका प्रोग्राम अपने लॉग के स्नैपशॉट से खुद बनाता है।
बिना अनुभव के क्या ऑटोमेट न करें
दो ऑपरेशन गलत होने पर महँगे पड़ते हैं: ट्रेड का एक्ज़ीक्यूशन और निकासी।
ट्रेड का एक्ज़ीक्यूशन
एक्सचेंज की ट्रेडिंग API से ऑर्डर लगाने वाला बॉट उतनी ही बार गलती करता है जितनी बार चलता है: हर 10 सेकंड की पोलिंग के साथ एंट्री शर्त में बग से घंटे में 3,600 / 10 = 360 ऑर्डर बनते हैं। डेटा भी पीछे रहता है: Genesis API का स्नैपशॉट प्लान के हिसाब से हर 60 से 5 सेकंड में ताज़ा होता है, order book एक्सचेंज से 5–20 सेकंड पीछे रहते हैं, और इतने में स्प्रेड बंद हो सकता है। Genesis API ऑर्डर नहीं लगाती: वह जोड़ियाँ ढूँढती है, और ट्रेड आप एक्सचेंज पर खुद खोलते हैं।
निकासी
निकासी की अनुमति वाली एक्सचेंज कुंजी जिसके भी हाथ लगे, वह अकाउंट से फ़ंड निकाल सकता है, इसलिए ऐसी कुंजी के लीक होने से पूरा बैलेंस जा सकता है। जो बॉट डेटा पढ़ते या ट्रेड करते हैं, उन्हें यह अनुमति नहीं चाहिए। Binance पर नई API key डिफ़ॉल्ट रूप से ट्रेड भी नहीं कर सकती: ट्रेडिंग की अनुमति अलग से चालू की जाती है।
साइट, एक्सचेंज API या Genesis API
| काम | बेहतर विकल्प | क्यों |
|---|---|---|
| जोड़ियाँ और चार्ट देखना | Genesis Arbitrage साइट | टेबल और फ़िल्टर, बिना कोड |
| प्रोग्रामिंग के बिना सिग्नल | साइट पर Telegram अलर्ट | थ्रेशोल्ड इंटरफ़ेस में सेट होते हैं |
| 20+ एक्सचेंज पर अपने नियम | Genesis API | स्प्रेड निकले हुए, एक फ़ॉर्मेट |
| ऑर्डर, बैलेंस, निकासी | एक्सचेंज API | ऑर्डर सिर्फ़ एक्सचेंज लेता है |
| हर ट्रेड रीयल टाइम में | एक्सचेंज WebSocket | Genesis API हर 60–5 सेकंड में स्नैपशॉट देती है |
| पिछली कैंडल | एक्सचेंज API | Genesis API में कैंडल नहीं हैं |
| 13 एक्सचेंज की funding history | Genesis API, Pro और Max | एक फ़ॉर्मेट में एक साल तक के दैनिक योग |
शुरुआत के लिए एक व्यावहारिक सेटअप: Genesis API जोड़ी ढूँढती है, आपका बॉट अलर्ट भेजता है, और आप एक्सचेंज की order book जाँचकर ट्रेड खुद खोलते हैं। Genesis API के प्लान Trial से शुरू होते हैं, $20 प्रति माह (500K कॉल, 60 सेकंड फ़्रेशनेस), और Max तक जाते हैं, $200 (10M कॉल, 5 सेकंड), और कोई मुफ़्त प्लान नहीं है। इनकी तुलना Genesis API की कीमतें पेज पर करें।
बाकी कोर्स के लिए क्या चाहिए
- Genesis API key: कीमतों के पेज पर प्लान चुनें और प्रोफ़ाइल में «कुंजी पाएँ» बटन से कुंजी लें; चरण Genesis API क्विक स्टार्ट में हैं। कुंजी को
GENESIS_API_KEYएनवायरनमेंट वेरिएबल में रखें और रिक्वेस्ट URL में कभी न डालें। - टर्मिनल से पहली रिक्वेस्ट के लिए curl।
- पाठ 2 और 4 की स्क्रिप्ट के लिए Python 3.10+ और
requestsलाइब्रेरी (pip install requests)। - Genesis API डॉक्यूमेंटेशन: हर endpoint के पैरामीटर, फ़ील्ड, curl उदाहरण और «आज़माएं» फ़ॉर्म हैं, जो रिक्वेस्ट सीधे पेज से भेजता है।
पाठ एक-दूसरे पर बने हैं:
- पाठ 2: आपकी पहली रिक्वेस्ट, पते, हेडर, स्टेटस कोड और JSON के साथ;
- पाठ 3: कौन-सा डेटा किन फ़ैसलों के काम आता है, स्प्रेड और order book से लेकर funding और on-chain प्रवाह तक;
- पाठ 4: Python में स्प्रेड और funding मॉनिटर;
- पाठ 5: ऑटोमेशन के जोखिम, जिनमें पुराना डेटा, त्रुटियाँ, कुंजियाँ और AI एजेंट शामिल हैं।
खुद आज़माएं
बिना कुंजी के रिक्वेस्ट भेजें
टर्मिनल में
curl "https://api.genesisarbitrage.com/health"चलाएँ। रिस्पॉन्स{"ok":true}का मतलब है कि रिक्वेस्ट पहुँची और सर्वर ने JSON में जवाब दिया।टेबल को फ़ील्ड से मिलाएँ
Spot – Spot टेबल और डॉक्स का Spot — Spot सेक्शन खोलें। एक्सचेंज, कीमत, स्प्रेड और ट्रांसफ़र स्टेटस के फ़ील्ड ढूँढें:
exchange_buy,price_sell,spread_pct,withdraw_enabled_buy।अपने रोज़ के काम सूचीबद्ध करें
तीन काम लें जो आप रोज़ करते हैं और हर एक को ऊपर की टेबल से चिह्नित करें: साइट, Genesis API या एक्सचेंज API।
एक काम के लिए endpoint खोजें
Genesis API वाले किसी काम के लिए डॉक्यूमेंटेशन में endpoint खोजें और ज़रूरी पैरामीटर लिख लें, जैसे
coinऔरmin_spread। वह रिक्वेस्ट आप पाठ 2 में भेजेंगे।