Genesis Arbitrage

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

Crypto API: market data API के प्रकार और ट्रेडिंग के लिए सही API कैसे चुनें

संक्षेप में

  • Crypto API आपके कोड को market data देता है: कीमतें, order book, funding rate, on-chain ट्रांज़ैक्शन और prediction market के भाव। Exchange API एक प्लेटफ़ॉर्म को कवर करता है और key से ऑर्डर लेता है; market data API कई प्लेटफ़ॉर्म को एक फ़ॉर्मैट में जोड़ता है।
  • API को नौ मानदंडों पर चुनें: प्लेटफ़ॉर्म और चेन कवरेज, डेटा की ताज़गी, फ़ील्ड नॉर्मलाइज़ेशन, डिपॉज़िट और विदड्रॉ स्टेटस, order book की गहराई, rate limit, कीमत, डॉक्यूमेंटेशन और डेटा के उपयोग की शर्तें।
  • Genesis API एक read-only REST API है: CEX, DEX, on-chain, prediction market और sportsbook surebet एक JSON फ़ॉर्मैट में, प्लान $20 प्रति माह से। यह ऑर्डर नहीं लगाता।

Crypto API एक प्रोग्रामिंग इंटरफ़ेस है, जिससे कोड crypto market data पढ़ता है या exchange को ऑर्डर भेजता है: कीमतें, order book, funding rate, ब्लॉकचेन ट्रांज़ैक्शन, prediction market के भाव। API के प्रकार दायरे में अलग हैं: exchange API एक प्लेटफ़ॉर्म को जानता है और key से ऑर्डर लेता है, market data API कई प्लेटफ़ॉर्म को एक फ़ॉर्मैट में जोड़ता है, और on-chain API ब्लॉकचेन पढ़ता है।

Crypto API के प्रकार

API का प्रकारक्या देता हैकब चाहिए
Exchange APIएक exchange की कीमतें, order book और ट्रेड; key से ऑर्डरउसी exchange पर ट्रेडिंग, किसी pair की ट्रेड स्ट्रीम
Market data APIकई exchange एक फ़ॉर्मैट में, तैयार स्प्रेडexchange की तुलना, स्कैनर, अलर्ट
On-chain APIट्रांज़ैक्शन, ट्रांसफ़र, बैलेंस, कॉन्ट्रैक्ट इवेंटव्हेल, exchange फ़्लो, अनलॉक
DEX APIपूल की कीमतें और लिक्विडिटी, स्वैप, स्लिपेजCEX पर न मिलने वाले टोकन, DEX – CEX सेटअप
डेरिवेटिव्स डेटाfunding, open interest, फ़्यूचर्स की कीमतेंfunding आर्बिट्राज, पोज़िशन का झुकाव
Prediction market और odds APIYES और NO की कीमतें, order book, बुकमेकर oddsprediction market आर्बिट्राज, surebet

Exchange API

Crypto exchange API एक प्लेटफ़ॉर्म का इंटरफ़ेस है और इसके दो हिस्से हैं। सार्वजनिक हिस्सा बिना key के market data देता है: Binance पर इन endpoint का सुरक्षा प्रकार NONE है, और GET /api/v3/ticker/price किसी pair की कीमत लौटाता है। निजी हिस्से — ऑर्डर, बैलेंस, ट्रेड इतिहास — के लिए API key और रिक्वेस्ट का सिग्नेचर चाहिए; Binance पर ये TRADE और USER_DATA प्रकार हैं (Binance डॉक्स)।

ऐसा API एक exchange को कवर करता है: किसी कॉइन की कीमत 20 exchange पर मिलानी हो तो अलग-अलग फ़ॉर्मैट और लिमिट वाले 20 कनेक्शन चाहिए।

Market data API

Market data API कई exchange से डेटा इकट्ठा करता है, उसे नॉर्मलाइज़ करता है और एक रिक्वेस्ट में लौटाता है। रिस्पॉन्स में पहले से वह सब होता है जो प्लेटफ़ॉर्म जोड़ने में लगता है: exchange के बीच स्प्रेड, एक अवधि में नॉर्मलाइज़ किए गए funding rate, exchange के हिसाब से open interest।

On-chain API

On-chain API ब्लॉकचेन पढ़ता है: ट्रांज़ैक्शन, टोकन ट्रांसफ़र, पतों के बैलेंस, स्मार्ट कॉन्ट्रैक्ट इवेंट। सबसे निचली परत नेटवर्क नोड है: हर Ethereum क्लाइंट JSON-RPC बोलता है, जिसमें eth_getBalance बैलेंस को wei में हेक्स संख्या के रूप में लौटाता है और eth_getLogs फ़िल्टर से मेल खाते कॉन्ट्रैक्ट इवेंट देता है।

नोड को नहीं पता कि कौन-से पते किसी exchange, टीम या व्हेल के हैं; ये लेबल इंडेक्सर और on-chain एनालिटिक्स सेवाएँ जोड़ती हैं। ट्रेडर को कौन-सा डेटा चाहिए, यह On-chain data API में है।

DEX API

DEX API विकेंद्रीकृत exchange पर पूल की कीमतें और लिक्विडिटी, स्वैप और स्लिपेज देता है। स्वैप पूल की लिक्विडिटी के मुक़ाबले जितना बड़ा हो, कीमत उतनी ज़्यादा हिलती है; इसलिए DEX – CEX सेटअप को आपके साइज़ का स्लिपेज चाहिए, और नए टोकन को टोकन टैक्स और हनीपॉट जाँच। विस्तार से DEX API में।

डेरिवेटिव्स डेटा: funding और open interest

परपेचुअल फ़्यूचर्स में स्पॉट के साथ funding rate, open interest (खुली पोज़िशन का वॉल्यूम) और फ़्यूचर्स की कीमत चाहिए। Exchange funding हर 8, 4 या 1 घंटे में सेटल करते हैं, इसलिए rate की तुलना एक अवधि में नॉर्मलाइज़ करने के बाद होती है। विस्तार से Funding rate API और Open interest API में।

Prediction market और odds API

Prediction प्लेटफ़ॉर्म YES और NO कॉन्ट्रैक्ट की कीमतें और order book देते हैं। Polymarket पर सार्वजनिक market data के लिए क्रेडेंशियल नहीं चाहिए, जबकि ऑर्डर के लिए ऑथेंटिकेशन और वॉलेट सिग्नेचर चाहिए (Polymarket डॉक्स)।

यहाँ भी फ़ॉर्मैट अलग हैं: Kalshi के order book में सिर्फ़ bid होते हैं, और YES का ask है $1 में से सबसे अच्छी NO bid घटाकर, यानी $0.56 की NO bid का मतलब $0.44 का YES ask (Kalshi डॉक्स)। बुकमेकर odds की तुलना YES और NO की कीमतों से implied probability के ज़रिए होती है — देखें Polymarket API और Kalshi API तथा Sports odds API।

REST और WebSocket

REST API रिक्वेस्ट पर आपके फ़िल्टर के अनुसार एक स्नैपशॉट लौटाता है, और अपडेट आपको शेड्यूल पर polling से मिलते हैं।

WebSocket कनेक्शन खुला रखता है, और सर्वर हर ट्रेड और order book के हर बदलाव को पुश करता है। बदले में आपको स्ट्रीम बिना छूट के प्रोसेस करनी होती है, कनेक्शन टूटने पर दोबारा जुड़ना होता है और स्नैपशॉट व अपडेट से book फिर से बनानी होती है; Kalshi तो सार्वजनिक चैनलों के लिए भी कनेक्ट करने पर ऑथेंटिकेशन माँगता है। सेकंड से कम की प्रतिक्रिया के लिए WebSocket चाहिए; 20+ exchange पर स्कैनर और अलर्ट REST से चलते हैं।

Genesis API सिर्फ़ REST है, WebSocket और webhook नहीं हैं: हर रिक्वेस्ट GET है, रिस्पॉन्स gzip से कंप्रेस्ड JSON हैं, और डेटा हर meta.freshness_sec सेकंड में रिफ़्रेश होता है। बिना फ़िल्टर का पूरा सेट माँगने वाली रिक्वेस्ट को If-None-Match में पिछले ETag के साथ दोहराएँ तो कुछ न बदलने पर बिना बॉडी का 304 मिलता है, और यह रिस्पॉन्स कोटा नहीं खाता। Polling के पैटर्न API polling की सर्वोत्तम पद्धतियाँ में हैं।

Crypto API कैसे चुनें: चेकलिस्ट

पहले छह मानदंड लाइव API रिस्पॉन्स में दिखते हैं; बाक़ी डॉक्स और प्राइसिंग में हैं।

मानदंडक्या जाँचें
प्लेटफ़ॉर्म और चेन कवरेजआपके exchange, स्पॉट और फ़्यूचर्स, DEX और चेन
ताज़गी और लेटेंसीरिस्पॉन्स में बनने का समय, रिफ़्रेश स्टेप, order book की उम्र
फ़ील्ड नॉर्मलाइज़ेशनएकसमान टिकर, इकाइयाँ, प्रतिशत और समय
डिपॉज़िट और विदड्रॉ स्टेटसहर exchange और नेटवर्क के लिए डिपॉज़िट व विदड्रॉ फ़्लैग
Order book की गहराईआपके साइज़ के लिए execution price
Rate limit और कोटाप्रति सेकंड रिक्वेस्ट, अवधि में कॉल, क्या कॉल गिना जाता है
कीमतप्लान या प्रति-कॉल भुगतान, लिमिट पार होने पर क्या होता है
डॉक्स और OpenAPIरिक्वेस्ट और रिस्पॉन्स के उदाहरण, एक spec
डेटा के उपयोग की शर्तेंक्या आप डेटा पर अपना प्रोडक्ट बना सकते हैं

कवरेज और ताज़गी

कवरेज को अपनी सूची से जाँचें: अगर आपका बॉट MEXC और Gate के साथ चलता है, तो इनमें से कोई एक न देने वाला API नहीं चलेगा। डेटा की ताज़गी यह है कि स्नैपशॉट बनने के बाद कितने सेकंड बीते; लेटेंसी exchange पर ट्रेड से आपके कोड तक का पूरा रास्ता है। मिनट भर पुराने स्नैपशॉट पर बॉट वे स्प्रेड देखता है जो पहले ही ख़त्म हो चुके हैं।

फ़ील्ड नॉर्मलाइज़ेशन

वही BTC/USDT pair exchange API में अलग लिखा जाता है: Binance पर BTCUSDT, OKX पर BTC-USDT (परपेचुअल BTC-USDT-SWAP), Gate पर BTC_USDT। Binance कीमतें स्ट्रिंग में लौटाता है (उसके डॉक्स के उदाहरण में "price": "4.00000200") और समय मिलीसेकंड में। आपके कोड को इनमें से हर अंतर संभालना होगा।

Market data API फ़ील्ड को एक रूप में लाता है, जैसे Genesis API डॉक्स की /funding/rates की इस एंट्री में:

{
  "coin": "TON",
  "exchanges": [
    {
      "exchange": "MEXC",
      "funding_pct": 0.02,
      "funding_8h_pct": 0.04,
      "next_payout": "00:00",
      "interval": "4h",
      "price": 2.184,
      "trade_url": "https://futures.mexc.com/exchange/TON_USDT"
    }
  ]
}

MEXC इस कॉइन की funding हर 4 घंटे में सेटल करता है, और प्रति अवधि 0.02% का rate funding_8h_pct में 8 घंटे पर नॉर्मलाइज़ होता है: 0.02 × 8 / 4 = 0.04% (देखें Funding rates)।

डिपॉज़िट और विदड्रॉ स्टेटस

स्पॉट पर exchange के बीच का सेटअप तभी अमल में आता है जब कॉइन ख़रीद वाले exchange से निकाला जा सके और बिक्री वाले exchange में जमा किया जा सके। Binance पर नेटवर्क स्टेटस GET /sapi/v1/capital/config/getall से आते हैं, जो साइन किया हुआ USER_DATA endpoint है और आपके अकाउंट की API key माँगता है (Binance डॉक्स)। Genesis API में स्टेटस हर Spot – Spot पंक्ति में withdraw_enabled_buy और deposit_enabled_sell के रूप में आते हैं (Spot — Spot डॉक्स)।

Order book की गहराई

सबसे अच्छी कीमत का स्प्रेड book के ऊपरी सिरे का अंतर दिखाता है, जबकि $5,000 का ट्रेड market depth के कई स्तर पार करता है। /orderbooks/spreads/spot-futures के Genesis API डॉक्स के उदाहरण में BTC स्प्रेड सबसे अच्छी कीमतों पर 0.031% है और $5,000 के लिए book पार करने के बाद 0.0202%। Execution prices endpoint $500–10,000 के लिए execution price लौटाता है; और जानकारी Crypto order book API में।

लिमिट, कीमत और डॉक्यूमेंटेशन

लिमिट अलग-अलग तरह से गिनी जाती हैं। Binance पर हर endpoint का एक वेट है, कई सिंबल पर रिक्वेस्ट भारी गिनी जाती हैं, और 429 के बाद भी रिक्वेस्ट भेजते रहने वाला IP 2 मिनट से 3 दिन तक बैन हो जाता है (Binance लिमिट)। डेटा API के लिए कॉल का कोटा, प्रति सेकंड rate limit और क्या कॉल गिना जाता है, यह जाँचें: Genesis API में सिर्फ़ 200 रिस्पॉन्स कोटा खाता है।

प्राइसिंग या तो कोटे वाला प्लान है या प्रति-कॉल भुगतान; पता करें कि लिमिट पार होने पर क्या होता है — 429 त्रुटि या अतिरिक्त शुल्क। OpenAPI spec API का मशीन-पठनीय विवरण है, जिससे क्लाइंट बनता है और AI एजेंट जुड़ते हैं, और उपयोग की शर्तें बताती हैं कि डेटा पर प्रोडक्ट बना सकते हैं या नहीं और क्या दोबारा नहीं बेच सकते।

एक रिक्वेस्ट में जाँच

यह स्क्रिप्ट पूरा Spot – Spot सेट खींचती है (हर Genesis API प्लान में उपलब्ध) और एक रिस्पॉन्स से कवरेज, स्नैपशॉट की उम्र और ट्रांसफ़र-योग्य सेटअप का हिस्सा जाँचती है:

import os
import time

import requests

BASE = "https://api.genesisarbitrage.com/v1"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}

r = requests.get(BASE + "/arbitrage/spot-spot",
                 headers=HEADERS, timeout=15)
r.raise_for_status()
body = r.json()
rows, meta = body["data"], body["meta"]

# कवरेज: सेटअप में कौन-से exchange दिखते हैं
venues = {x["exchange_buy"] for x in rows}
venues |= {x["exchange_sell"] for x in rows}
print("exchanges in response:", len(venues), sorted(venues))

# ताज़गी: स्नैपशॉट की उम्र और प्लान का रिफ़्रेश स्टेप
age = time.time() - meta["updated_at"]
print(f"snapshot {age:.0f} s old, plan step {meta['freshness_sec']} s")

# ट्रांसफ़र: ख़रीद की तरफ़ विदड्रॉ खुला, बिक्री की तरफ़ डिपॉज़िट खुला
ok = [x for x in rows
      if x["withdraw_enabled_buy"] and x["deposit_enabled_sell"]]
print(f"transferable setups: {len(ok)} of {len(rows)}")

429 और 503 पर रीट्राई Genesis API के रिस्पॉन्स और त्रुटियाँ के get_json फ़ंक्शन से आते हैं। फिर 3–5 सेटअप की कीमतें और स्टेटस trade_url_buy और trade_url_sell के ज़रिए exchange पर जाँचें।

ख़ुद का कोड या तैयार API

एक-दो exchange और ट्रेडिंग के लिए उनके API पर ख़ुद का कोड स्वाभाविक चुनाव है। स्पॉट और फ़्यूचर्स वाले 20 exchange के लिए इसका मतलब है 40 तक market data कनेक्टर: Binance पर स्पॉट और USDⓈ-M फ़्यूचर्स अलग API हैं, api.binance.com और fapi.binance.com। हर कनेक्टर में REST स्नैपशॉट, रीकनेक्ट वाली WebSocket स्ट्रीम, अपनी लिमिट और सिंबल फ़ॉर्मैट होते हैं, और ऊपर से जोड़ने का काम: कॉइन कॉन्ट्रैक्ट और नेटवर्क से मिलाए जाते हैं, क्योंकि एक ही टिकर अलग exchange पर अलग टोकन हो सकता है।

कामExchange API पर ख़ुद का कोडGenesis API
ऑर्डर लगानाएकमात्र रास्ता: exchange का ट्रेडिंग APIनहीं, read-only
एक pair का हर ट्रेडExchange WebSocketनहीं, हर 60–5 सेकंड में स्नैपशॉट
20+ exchange में स्प्रेड40 तक कनेक्टर और जोड़नाएक रिक्वेस्ट
डिपॉज़िट और विदड्रॉ स्टेटसहर exchange का अलग endpoint, Binance पर key के साथसेटअप पंक्ति के फ़ील्ड
DEX, on-chain, prediction marketनोड, इंडेक्सर, प्लेटफ़ॉर्म के APIवही JSON फ़ॉर्मैट

दोनों तरीक़े साथ चल सकते हैं: डेटा API सेटअप ढूँढता है, और ट्रेड exchange पर हाथ से या उसके ट्रेडिंग API से बिना विदड्रॉ अधिकार वाली key के साथ खोला जाता है (देखें अपने crypto exchange अकाउंट को सुरक्षित कैसे करें)। Telegram अलर्ट वाला बॉट Python में Crypto Arbitrage Bot में बनता है।

Genesis API कहाँ फ़िट बैठता है

Genesis API, Genesis Arbitrage डेटा का REST API है: CEX, DEX, on-chain, prediction market और sportsbook surebet एक JSON फ़ॉर्मैट में, key X-API-Key हेडर में। यह वही डेटा देता है जो साइट प्रकाशित करती है, 35+ endpoint के ज़रिए (spec में 37 ऑपरेशन), और सिर्फ़ डेटा पढ़ता है।

डेटाendpoint का उदाहरणAPI प्लान
CEX स्प्रेड/arbitrage/spot-spotसभी
DEX और क्रॉस-चेन/arbitrage/dex-spotPro, Max
Order book/orderbooks/execPro, Max
Funding और OI/funding/ratesसभी
On-chain/onchain/{section}Start, Pro, Max
Prediction market और surebet/predictions/arbitrageStart: exact, dutch; Pro, Max: llm, sport

कवरेज: 20+ CEX exchange (Binance, OKX, Bybit, Bitget, MEXC, Gate, BingX, Kraken, WhiteBit, Coinbase, CoinW, edgeX, HTX, Hyperliquid और अन्य), 1000+ कॉइन की funding जो 8 घंटे पर नॉर्मलाइज़ है, 13+ फ़्यूचर्स exchange पर open interest। Prediction market हैं Polymarket, Kalshi, Limitless, Predict.fun और Opinion; sport मोड 13 प्लेटफ़ॉर्म पर sportsbook surebet बनाता है, सिर्फ़ मैच से पहले।

प्लानप्रति माह कॉलप्रति सेकंड रिक्वेस्टताज़गी
Trial, $20/माह500K160 से
Start, $502M230 से
Pro, $1005M510 से
Max, $20010M155 से

API प्लान साइट की सब्सक्रिप्शन से अलग हैं; भुगतान crypto में होता है, 3 महीने पर 10% और 6 महीने पर 20% की छूट के साथ। लिमिट पार होने पर सर्वर 429 लौटाता है और कुछ नहीं काटता, और आपके प्लान से बाहर का endpoint 403 plan_restricted लौटाता है। प्लान की तुलना Genesis API की कीमतें में करें; नियम प्लान और लिमिट में हैं।

डॉक्यूमेंटेशन के हर सेक्शन का अपना URL है, जिसमें पैरामीटर, फ़ील्ड, curl का उदाहरण और आज़माएं फ़ॉर्म है। प्रोग्राम और AI एजेंट के लिए OpenAPI 3.1 spec और llms-full.txt रेफ़रेंस है; सेटअप AI एजेंट के लिए Genesis API में है। Genesis API पर आप अपनी सेवाएँ, बॉट और डैशबोर्ड बना सकते हैं; कच्चा डेटा जस का तस दोबारा नहीं बेच सकते।

पहली रिक्वेस्ट — प्लान, प्रोफ़ाइल में key और X-API-Key के साथ GET — क्विकस्टार्ट में है, और बुनियादी बातें पाठ Crypto API क्या है और क्या ऑटोमेट किया जा सकता है में। बिना कोड के वही डेटा साइट की तालिकाओं और Telegram अलर्ट में है।

सवाल और जवाब

क्या कोई मुफ़्त crypto API है?

हाँ: सार्वजनिक exchange API कीमतें, order book और ट्रेड मुफ़्त और बिना key के देते हैं (Binance पर NONE endpoint), पर हर एक सिर्फ़ एक exchange को कवर करता है। Genesis API में मुफ़्त प्लान नहीं है: Trial 500K कॉल के लिए $20 प्रति माह है।

Crypto API इस्तेमाल करने के लिए क्या SDK चाहिए?

REST API के लिए HTTP क्लाइंट काफ़ी है: curl, Python में requests या JavaScript में fetch। Genesis API का कोई आधिकारिक SDK नहीं है, और हर रिक्वेस्ट एक हेडर वाला GET है; OpenAPI 3.1 spec से आप टाइप्ड क्लाइंट बना सकते हैं।

क्या market data API से ट्रेड कर सकते हैं?

नहीं, अगर API read-only है, जैसे Genesis API: यह सेटअप ढूँढता है पर ऑर्डर नहीं लगाता। ऑर्डर exchange के ज़रिए जाते हैं, हाथ से या उसके ट्रेडिंग API से key और सिग्नेचर के साथ (Binance पर TRADE endpoint), जो Genesis API के बाहर है और आपके अपने जोखिम पर।

API से crypto की कीमत कैसे लें?

Exchange का सार्वजनिक endpoint उसी exchange पर pair की कीमत लौटाता है: Binance पर यह GET /api/v3/ticker/price है, और कीमत स्ट्रिंग में आती है। किसी कॉइन की हर exchange पर कीमतें, डिपॉज़िट और विदड्रॉ स्टेटस के साथ, Genesis API में /coins/search?query=BTC से मिलती हैं (देखें Coin Search)।