Genesis API आर्बिट्राज endpoint: CEX, DEX, क्रॉस-चेन और स्टॉक
संक्षेप में
- सात endpoint साइट की तालिकाओं वाले ही जोड़े लौटाते हैं: तीनों CEX डेटासेट हर प्लान में, स्टॉक Start से ऊपर, और DEX - स्पॉट, DEX - फ्यूचर्स और क्रॉसचेन Pro और Max में।
- CEX पंक्ति में दोनों एक्सचेंजों की कीमतें और सबसे अच्छे कोट, नेटवर्क, कॉन्ट्रैक्ट, डिपॉज़िट-विदड्रॉल की स्थिति और वॉल्यूम होते हैं — वे फ़ील्ड जिनसे आप सचमुच चलाने लायक जोड़े चुनते हैं।
- रिस्पॉन्स का स्प्रेड स्नैपशॉट के समय का कीमत अंतर है: उसमें से फ़ीस, ट्रांसफ़र और स्लिपेज नहीं घटाए गए हैं।
Genesis API के आर्बिट्राज endpoint वही जोड़े लौटाते हैं जो Genesis Arbitrage की तालिकाओं में हैं: CEX के स्पॉट और फ्यूचर्स बाज़ारों के बीच, DEX और CEX के बीच, नेटवर्कों के बीच और टोकनाइज़्ड स्टॉक पर स्प्रेड। data का हर आइटम एक जोड़ा है: कहाँ खरीदें, कहाँ बेचें, स्प्रेड — प्रतिशत में कीमत का अंतर — और उसे जाँचने वाले फ़ील्ड: डिपॉज़िट और विदड्रॉल की स्थिति, वॉल्यूम, लिक्विडिटी, लिंक। सातों endpoint GET रिक्वेस्ट हैं और कुंजी X-API-Key हेडर में जाती है।
सात endpoint और प्लान
| Endpoint | क्या लौटाता है | प्लान |
|---|---|---|
/arbitrage/spot-spot | CEX स्पॉट बाज़ारों के बीच स्प्रेड | Trial, Start, Pro, Max |
/arbitrage/spot-futures | CEX पर स्पॉट बनाम फ्यूचर्स | Trial, Start, Pro, Max |
/arbitrage/futures-futures | CEX एक्सचेंजों के बीच फ्यूचर्स | Trial, Start, Pro, Max |
/arbitrage/dex-spot | DEX कीमत बनाम CEX स्पॉट | Pro, Max |
/arbitrage/dex-futures | DEX कीमत बनाम CEX फ्यूचर्स | Pro, Max |
/arbitrage/crosschain | DEX पर एक टोकन, नेटवर्कों के पार | Pro, Max |
/arbitrage/stocks | CEX पर टोकनाइज़्ड स्टॉक, धातुएँ, इंडेक्स और कमोडिटी | Start, Pro, Max |
प्लान से बाहर का endpoint 403 plan_restricted लौटाता है; एरर कोड Genesis API के रिस्पॉन्स और एरर में हैं, और कीमतें Genesis API की कीमतें पेज पर।
CEX: स्पॉट - स्पॉट, स्पॉट - फ्यूचर्स, फ्यूचर्स - फ्यूचर्स
तीनों CEX endpoint एक जैसे पैरामीटर लेते हैं और एक ही प्रारूप की पंक्तियाँ लौटाते हैं। market_buy और market_sell फ़ील्ड हर तरफ़ का बाज़ार बताते हैं: spot और spot, या spot और futures, या futures और futures।
| पैरामीटर | प्रकार | क्या करता है | उदाहरण |
|---|---|---|---|
coin | string | कॉइन टिकर से फ़िल्टर | coin=BTC |
exchange | string | एक्सचेंज से फ़िल्टर; कई हों तो कॉमा से | exchange=Binance,OKX |
min_spread | number | न्यूनतम स्प्रेड, % | min_spread=1 |
min_volume | number | दोनों तरफ़ न्यूनतम 24 घंटे का वॉल्यूम, USD | min_volume=50000 |
curl -G --compressed \
"https://api.genesisarbitrage.com/v1/arbitrage/spot-spot" \
-d min_spread=1 -d min_volume=50000 \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
curl -G --compressed \
"https://api.genesisarbitrage.com/v1/arbitrage/spot-futures" \
-d coin=BTC -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
curl -G --compressed \
"https://api.genesisarbitrage.com/v1/arbitrage/futures-futures" \
-d exchange=Binance,OKX -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
स्पॉट - स्पॉट डॉक्यूमेंटेशन से एक रिस्पॉन्स पंक्ति, संक्षिप्त:
{
"coin": "FUEL",
"exchange_buy": "ByBit",
"exchange_sell": "Gate",
"market_buy": "spot",
"market_sell": "spot",
"price_buy": 0.0007029,
"price_sell": 0.0007037,
"ask_buy": 0.0007029,
"bid_sell": 0.0007021,
"spread_pct": 0.11,
"network": "ETH",
"contract": "0x675B68AA4d9c2d3BB3F0397048e62E6B7192079c",
"withdraw_enabled_buy": true,
"deposit_enabled_sell": true,
"volume_24h_buy": 17652.64,
"volume_24h_sell": 12512.51,
"trade_url_buy": "https://www.bybit.com/trade/spot/FUEL/USDT",
…
}
| फ़ील्ड | प्रकार | सामग्री |
|---|---|---|
exchange_buy, exchange_sell | string | खरीद का एक्सचेंज और बिक्री का एक्सचेंज |
market_buy, market_sell | string | उस तरफ़ का बाज़ार: spot या futures |
price_buy, price_sell | number | वे कीमतें जिनसे स्प्रेड निकलता है |
bid_*, ask_* | number या null | हर तरफ़ का सबसे अच्छा bid और ask |
spread_pct | number | स्प्रेड, % |
network, contract | string; string या null | टोकन का नेटवर्क और कॉन्ट्रैक्ट पता |
deposit_enabled_*, withdraw_enabled_* | boolean | हर एक्सचेंज पर डिपॉज़िट और विदड्रॉल खुले हैं या नहीं |
volume_24h_buy, volume_24h_sell | number या null | 24 घंटे का वॉल्यूम, USD |
trade_url_buy, trade_url_sell | string | ट्रेडिंग टर्मिनल के लिंक |
spread_pct की गणना price_buy और price_sell से होती है — साइट पर «कीमत» कॉलम, यानी आख़िरी ट्रेड। ट्रेड ख़ुद ऑर्डर बुक से होता है: आप ask_buy पर खरीदते हैं और bid_sell पर बेचते हैं। उदाहरण में bid_sell, ask_buy से नीचे है, इसलिए सबसे अच्छे कोट पर जोड़ा ऋणात्मक है:
(0.0007021 − 0.0007029) / 0.0007029 × 100 ≈ −0.11%
आपके साइज़ का सटीक अंतर ऑर्डर-बुक Δ से मिलता है — GET /orderbooks/spreads/{dataset}, जो ऑर्डर बुक endpoint गाइड में समझाया गया है।
ट्रांसफ़र योग्य स्पॉट - स्पॉट जोड़े
दो एक्सचेंजों के बीच स्पॉट जोड़ा तभी चलता है जब कॉइन को ले जाया जा सके: एक एक्सचेंज पर खरीदना, निकालना और दूसरे पर जमा होना। इसके लिए खरीद वाले एक्सचेंज पर विदड्रॉल खुला (withdraw_enabled_buy) और बिक्री वाले पर डिपॉज़िट खुला (deposit_enabled_sell) होना चाहिए। रिक्वेस्ट में इन फ़्लैग के पैरामीटर नहीं हैं, इसलिए आप इन्हें कोड में फ़िल्टर करते हैं, जबकि min_volume कम लिक्विडिटी वाले कॉइन सर्वर पर ही हटा देता है।
import os
import requests
r = requests.get(
"https://api.genesisarbitrage.com/v1/arbitrage/spot-spot",
headers={"X-API-Key": os.environ["GENESIS_API_KEY"]},
params={"min_spread": 1, "min_volume": 50000},
timeout=15,
)
r.raise_for_status()
rows = r.json()["data"]
# ट्रांसफ़र तभी चलता है जब खरीद वाले एक्सचेंज पर विदड्रॉल
# और बिक्री वाले पर डिपॉज़िट खुला हो
ok = [x for x in rows
if x["withdraw_enabled_buy"] and x["deposit_enabled_sell"]]
ok.sort(key=lambda x: x["spread_pct"], reverse=True)
for x in ok[:10]:
print(f'{x["coin"]:<8} {x["exchange_buy"]} → '
f'{x["exchange_sell"]} {x["spread_pct"]}% '
f'network {x["network"]}')
429 और 503 पर रीट्राई Genesis API के रिस्पॉन्स और एरर के get_json फ़ंक्शन से होता है। ये जोड़े Telegram पर भेजने वाला बॉट Python में Crypto Arbitrage Bot लेख में बनाया गया है।
DEX - स्पॉट और DEX - फ्यूचर्स
DEX डेटासेट किसी टोकन की DEX, यानी विकेंद्रीकृत एक्सचेंज, पर कीमत की तुलना CEX की कीमत से करते हैं: DEX - स्पॉट की स्पॉट से, DEX - फ्यूचर्स की फ्यूचर्स से। दोनों endpoint Pro और Max प्लान में हैं।
| पैरामीटर | प्रकार | क्या करता है | उदाहरण |
|---|---|---|---|
coin | string | कॉइन टिकर से फ़िल्टर | coin=SCR |
exchange | string | CEX एक्सचेंज; कई हों तो कॉमा से | exchange=MEXC |
min_spread | number | न्यूनतम स्प्रेड, % | min_spread=2 |
min_liquidity | number | न्यूनतम लिक्विडिटी, USD | min_liquidity=50000 |
curl -G --compressed \
"https://api.genesisarbitrage.com/v1/arbitrage/dex-spot" \
-d min_spread=2 -d min_liquidity=50000 \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
curl -G --compressed \
"https://api.genesisarbitrage.com/v1/arbitrage/dex-futures" \
-d min_spread=1 -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
डॉक्यूमेंटेशन से DEX - स्पॉट की एक पंक्ति, संक्षिप्त:
{
"coin": "SCR",
"exchange": "MEXC",
"cex_price": 0.02691,
"dex_price": 0.02679,
"spread_pct": 0.45,
"network": "SCROLL",
"liquidity_usd": 10544.15,
"market_cap": 5091835.0,
"deposit_enabled": true,
"withdraw_enabled": true,
"dexscreener_url": "https://dexscreener.com/scroll/0xd296…",
"dextools_url": null,
"gmgn_url": null,
…
}
MEXC की कीमत पूल की कीमत से ऊपर है, इसलिए स्प्रेड धनात्मक है। spread_pct का चिह्न दिशा तय करता है: धन का मतलब टोकन DEX पर सस्ता है, वहाँ खरीदें और CEX पर बेचें; ऋण का मतलब उल्टा।
| फ़ील्ड | प्रकार | सामग्री |
|---|---|---|
exchange | string | CEX एक्सचेंज |
cex_price, dex_price | number | CEX और DEX पर कीमत |
liquidity_usd | number | पूल की लिक्विडिटी, USD |
market_cap, dex_volume_24h | number या null | मार्केट कैप और 24 घंटे का DEX वॉल्यूम (DEX - स्पॉट) |
ticker, max_position_usd | string; number या null | एक्सचेंज का जोड़ा और अधिकतम पोज़िशन, USD (DEX - फ्यूचर्स) |
deposit_enabled, withdraw_enabled | boolean | CEX पर डिपॉज़िट और विदड्रॉल खुले हैं या नहीं |
dexscreener_url, dextools_url, gmgn_url | string या null | DexScreener, DEXTools और GMGN के लिंक |
उदाहरण के पूल में $10,544 की लिक्विडिटी है, इसलिए बड़ी खरीद उसकी कीमत हिला देगी। $100 से $100,000 तक के साइज़ का स्लिपेज, टोकन टैक्स और हर कॉन्ट्रैक्ट का हनीपॉट फ़्लैग Pro और Max प्लान में GET /orderbooks/dex-slippage से मिलता है।
क्रॉस-चेन: नेटवर्कों के पार एक टोकन
GET /arbitrage/crosschain एक टोकन की DEX कीमत की तुलना ब्लॉकचेनों के बीच करता है, Pro और Max प्लान में। पंक्ति में coin, spread_pct और एक जैसे फ़ील्ड वाले दो ऑब्जेक्ट होते हैं: buy, जहाँ टोकन सस्ता है, और sell, जहाँ महँगा है। टोकन नेटवर्कों के बीच क्रॉस-चेन ब्रिज से जाता है।
| पैरामीटर | प्रकार | क्या करता है | उदाहरण |
|---|---|---|---|
coin | string | टोकन टिकर से फ़िल्टर | coin=WLD |
chain | string | नेटवर्क से फ़िल्टर | chain=ethereum |
min_spread | number | न्यूनतम स्प्रेड, % | min_spread=1 |
min_liquidity | number | न्यूनतम लिक्विडिटी, USD | min_liquidity=20000 |
curl -G --compressed \
"https://api.genesisarbitrage.com/v1/arbitrage/crosschain" \
-d coin=WLD -d min_liquidity=20000 \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
क्रॉसचेन डॉक्यूमेंटेशन से एक पंक्ति, संक्षिप्त:
{
"coin": "WLD",
"spread_pct": 0.59,
"buy": {
"chain": "optimism",
"pair": "WLD/USDC",
"price_usd": 0.4048,
"liquidity_usd": 48747,
"volume_24h_usd": 2484,
"pool_created_at": "2023-07-24 08:44:19 UTC",
…
},
"sell": {
"chain": "ethereum",
"pair": "WLD/WETH",
"price_usd": 0.4072,
"liquidity_usd": 421426,
…
}
}
| फ़ील्ड | प्रकार | सामग्री |
|---|---|---|
buy.chain | string | उस तरफ़ का नेटवर्क |
buy.pair | string | DEX जोड़ा, जैसे WLD/USDC |
buy.contract | string | उस नेटवर्क पर कॉन्ट्रैक्ट पता |
buy.price_usd, buy.liquidity_usd, buy.volume_24h_usd | number | कीमत, पूल की लिक्विडिटी और 24 घंटे का वॉल्यूम, USD |
buy.pool_created_at | string या null | पूल बनने की तारीख़ |
buy.dexscreener_url, dextools_url, gmgn_url | string या null | DexScreener, DEXTools और GMGN के लिंक |
sell में भी यही फ़ील्ड हैं। pool_created_at UTC की तारीख़ वाली स्ट्रिंग है, API के ज़्यादातर टाइमस्टैम्प की तरह unix सेकंड नहीं, और null हो सकती है। कुछ दिन पहले बना पूल दोनों तरफ़ के कॉन्ट्रैक्ट जाँचने की वजह है: नए नेटवर्क पर उसी टिकर के पीछे कोई और टोकन हो सकता है।
स्टॉक आर्बिट्राज: स्टॉक, धातुएँ, इंडेक्स, कमोडिटी
GET /arbitrage/stocks CEX एक्सचेंजों के बीच टोकनाइज़्ड स्टॉक, धातुओं, इंडेक्स और कमोडिटी पर स्प्रेड लौटाता है और Start प्लान से ऊपर उपलब्ध है।
| पैरामीटर | प्रकार | क्या करता है | उदाहरण |
|---|---|---|---|
symbol | string | इंस्ट्रूमेंट टिकर से फ़िल्टर | symbol=BRENT |
category | string | श्रेणी: Stock, Metal, Index या Commodity | category=Commodity |
exchange | string | एक्सचेंज से फ़िल्टर; कई हों तो कॉमा से | exchange=MEXC |
min_spread | number | न्यूनतम स्प्रेड, % | min_spread=0.3 |
curl -G --compressed \
"https://api.genesisarbitrage.com/v1/arbitrage/stocks" \
-d category=Commodity -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
स्टॉक आर्बिट्राज डॉक्यूमेंटेशन से एक पंक्ति, संक्षिप्त:
{
"symbol": "BRENT",
"category": "Commodity",
"exchange_buy": "MEXC",
"exchange_sell": "Ourbit",
"symbol_on_buy": "UKOIL",
"symbol_on_sell": "BRENTOIL",
"price_buy": 76.68,
"price_sell": 76.82,
"spread_pct": 0.18,
…
}
symbol इंस्ट्रूमेंट का आम टिकर है, जबकि symbol_on_buy और symbol_on_sell हर एक्सचेंज पर उसके नाम हैं: उदाहरण में ब्रेंट क्रूड MEXC पर UKOIL और Ourbit पर BRENTOIL के नाम से ट्रेड होता है। एक्सचेंज पर इंस्ट्रूमेंट symbol_on_* से खोजें। पंक्ति में नेटवर्क, कॉन्ट्रैक्ट या डिपॉज़िट फ़ील्ड नहीं हैं: CEX पर ये इंस्ट्रूमेंट परपेचुअल फ्यूचर्स की तरह ट्रेड होते हैं, और जोड़ा Long और Short पोज़िशन से खुलता है (तालिका गाइड)।
API रिस्पॉन्स और साइट की तालिकाएँ
साइट की तालिकाओं के कॉलम गाइड में समझाए गए हैं:
| Endpoint | साइट की तालिका और उसकी गाइड |
|---|---|
/arbitrage/spot-spot | स्पॉट - स्पॉट |
/arbitrage/spot-futures | स्पॉट - फ्यूचर्स |
/arbitrage/futures-futures | फ्यूचर्स आर्बिट्राज |
/arbitrage/dex-spot | DEX - स्पॉट |
/arbitrage/dex-futures | DEX - फ्यूचर्स |
/arbitrage/crosschain | क्रॉसचेन |
/arbitrage/stocks | स्टॉक आर्बिट्राज |
जोड़ों का मॉनिटर कैसे बनाएँ
अपने प्लान के लिए endpoint चुनें
ऊपर की प्लान तालिका देखें: DEX डेटासेट और क्रॉसचेन सिर्फ़ Pro और Max में हैं।
सर्वर पर सेट को छोटा करें
min_spreadअपनी फ़ीस के योग से ऊपर रखें, और कम लिक्विडिटी वाले कॉइन हटाने के लिएmin_volumeयाmin_liquidityलगाएँ।चलने लायक पंक्तियाँ कोड में रखें
स्पॉट - स्पॉट —
withdraw_enabled_buyऔरdeposit_enabled_sell। धनात्मक स्प्रेड वाला DEX - स्पॉट —deposit_enabled, ऋणात्मक वाला —withdraw_enabled। स्टॉक —symbol_on_buyऔरsymbol_on_sellसे खोजें।टोकन और ऑर्डर बुक जाँचें
contractऔरnetworkमिलाएँ, और अपने साइज़ का एक्ज़ीक्यूशन ऑर्डर बुक endpoint से निकालें।अपने प्लान की गति से पोल करें
meta.freshness_secसे ज़्यादा बार नहीं। बॉट अलर्ट भेजता है, और ट्रेड आप ख़ुद एक्सचेंज पर लगाते हैं।
सवाल और जवाब
क्या ये endpoint ट्रेड लगा सकते हैं?
नहीं। Genesis API सिर्फ़ डेटा देता है और कोई ऑर्डर नहीं लगाता। Genesis API पर बना बॉट जोड़ा खोजता है और आपको अलर्ट भेजता है, और ट्रेड आप ख़ुद एक्सचेंज पर खोलते हैं।
पंक्तियों में Book या Ord. कॉलम क्यों नहीं हैं?
दोनों ऑर्डर बुक से गणना होते हैं और अलग आते हैं: ऑर्डर-बुक Δ GET /orderbooks/spreads/{dataset} से और बाज़ार की ऑर्डर बुक GET /orderbooks/book से, दोनों Pro और Max प्लान में।
DEX और क्रॉसचेन के लिए कौन सा प्लान चाहिए?
Pro या Max। Trial तीनों CEX डेटासेट कवर करता है, और Start स्टॉक आर्बिट्राज जोड़ता है।