API
API (application programming interface) नियमों का वह सेट है जिससे एक प्रोग्राम दूसरे से डेटा या कार्रवाई माँगता है: कौन-सा URL बुलाना है, क्या भेजना है और जवाब किस फ़ॉर्मेट में आएगा। ट्रेडर को API तब चाहिए जब कीमतें, order book और funding rate किसी प्रोग्राम को पढ़नी हों: बॉट, स्प्रेडशीट या डैशबोर्ड।
Request का उदाहरण
काल्पनिक उदाहरण: एक प्रोग्राम Coin Search सेक्शन के endpoint से Genesis API में IRYS कॉइन की प्रोफ़ाइल माँगता है। request एक HTTP GET है, और key हेडर में जाती है:
curl "https://api.genesisarbitrage.com/v1/coins/search?query=IRYS" \
-H "X-API-Key: $GENESIS_API_KEY"
जवाब JSON में आता है, कुछ फ़ील्ड हटा दिए गए हैं:
{
"coin": "IRYS",
"contracts": [
{
"address": "0x91152b4ef635403efbae860edd0f8c321d7c035d",
"network": "BNB Smart Chain(BEP20)",
"exchanges": ["MEXC", "Ourbit"]
}
],
"exchanges": {
"MEXC": {
"spot_price": 0.01329,
"futures_price": 0.0133,
"deposit": true,
"withdraw": true
}
}
}
इंसान यह जानकारी एक्सचेंज के पेजों और block explorer से जोड़ता है; प्रोग्राम इसे एक ही जवाब में पा लेता है और तुरंत गिन लेता है कि MEXC के futures spot से (0.0133 − 0.01329) / 0.01329 × 100 ≈ 0.075% ऊपर ट्रेड हो रहे हैं।
एक्सचेंज के पब्लिक और प्राइवेट API
एक्सचेंज API के दो हिस्से होते हैं। पब्लिक हिस्सा बाज़ार का डेटा (कीमतें, order book, ट्रेड) बिना key के देता है। प्राइवेट हिस्सा आपके अकाउंट के साथ काम करता है (बैलेंस, ऑर्डर, ट्रेड इतिहास) और इसके लिए API key और request का signature चाहिए। Binance पर पब्लिक endpoint का सिक्योरिटी टाइप NONE है; बाक़ी सबको key और signature पैरामीटर चाहिए।
डेटा दो तरह से आता है। REST API हर request का अलग से जवाब देता है: इससे आप अपने फ़िल्टरों के साथ डेटा का स्नैपशॉट लेते हैं। WebSocket कनेक्शन खुला रखता है और सर्वर अपडेट ख़ुद भेजता है: Binance इसी तरह ट्रेड और order book के बदलाव रीयल टाइम में भेजता है।
डेटा API: एक जवाब में कई प्लेटफ़ॉर्म
एक्सचेंज API सिर्फ़ अपने प्लेटफ़ॉर्म को जानता है। किसी कॉइन की कीमत 20 एक्सचेंज पर मिलाने के लिए प्रोग्राम को 20 कनेक्शन चाहिए, और हर एक्सचेंज का जवाब फ़ॉर्मेट और लिमिट अलग है। डेटा API प्लेटफ़ॉर्म पहले से जोड़ देता है।
| API का प्रकार | क्या लौटाता है | एक्सेस |
|---|---|---|
| एक्सचेंज का पब्लिक API | एक एक्सचेंज की कीमतें, order book और ट्रेड | बिना key |
| एक्सचेंज का प्राइवेट API | बैलेंस, ऑर्डर, निकासी | key और signature |
| Genesis API | स्प्रेड, order book, funding, DEX, ऑन-चेन, प्रेडिक्शन मार्केट | key, केवल पढ़ना |
Genesis API के /arbitrage/spot-spot endpoint की एक request 20+ CEX एक्सचेंज के spot बाज़ारों के बीच गिने हुए स्प्रेड लौटाती है, deposit और withdrawal फ़्लैग के साथ। हर request HTTP GET है, हर जवाब JSON है, और हर endpoint के पैरामीटर और फ़ील्ड डॉक्यूमेंटेशन में हैं।
यह भी देखें: Crypto API: प्रकार और चुनाव कैसे करें, डॉक्स में क्विकस्टार्ट, rate limit, पाठ: Crypto API क्या है।
सवाल और जवाब
API के साथ काम करने के लिए क्या SDK चाहिए?
अगर API HTTP पर चलता है तो कोई भी HTTP क्लाइंट चलेगा। Genesis API के लिए curl, Python का requests या JavaScript का बिल्ट-इन fetch काफ़ी है।
क्या Genesis API से ट्रेड किया जा सकता है?
नहीं। Genesis API सिर्फ़ डेटा देता है। ऑर्डर आप एक्सचेंज पर हाथ से या एक्सचेंज के अपने API और उसकी key से लगाते हैं, अपनी ज़िम्मेदारी पर।