Genesis Arbitrage

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

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-spotCEX स्पॉट बाज़ारों के बीच स्प्रेडTrial, Start, Pro, Max
/arbitrage/spot-futuresCEX पर स्पॉट बनाम फ्यूचर्सTrial, Start, Pro, Max
/arbitrage/futures-futuresCEX एक्सचेंजों के बीच फ्यूचर्सTrial, Start, Pro, Max
/arbitrage/dex-spotDEX कीमत बनाम CEX स्पॉटPro, Max
/arbitrage/dex-futuresDEX कीमत बनाम CEX फ्यूचर्सPro, Max
/arbitrage/crosschainDEX पर एक टोकन, नेटवर्कों के पारPro, Max
/arbitrage/stocksCEX पर टोकनाइज़्ड स्टॉक, धातुएँ, इंडेक्स और कमोडिटीStart, Pro, Max

प्लान से बाहर का endpoint 403 plan_restricted लौटाता है; एरर कोड Genesis API के रिस्पॉन्स और एरर में हैं, और कीमतें Genesis API की कीमतें पेज पर।

CEX: स्पॉट - स्पॉट, स्पॉट - फ्यूचर्स, फ्यूचर्स - फ्यूचर्स

तीनों CEX endpoint एक जैसे पैरामीटर लेते हैं और एक ही प्रारूप की पंक्तियाँ लौटाते हैं। market_buy और market_sell फ़ील्ड हर तरफ़ का बाज़ार बताते हैं: spot और spot, या spot और futures, या futures और futures।

पैरामीटरप्रकारक्या करता हैउदाहरण
coinstringकॉइन टिकर से फ़िल्टरcoin=BTC
exchangestringएक्सचेंज से फ़िल्टर; कई हों तो कॉमा सेexchange=Binance,OKX
min_spreadnumberन्यूनतम स्प्रेड, %min_spread=1
min_volumenumberदोनों तरफ़ न्यूनतम 24 घंटे का वॉल्यूम, USDmin_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_sellstringखरीद का एक्सचेंज और बिक्री का एक्सचेंज
market_buy, market_sellstringउस तरफ़ का बाज़ार: spot या futures
price_buy, price_sellnumberवे कीमतें जिनसे स्प्रेड निकलता है
bid_*, ask_*number या nullहर तरफ़ का सबसे अच्छा bid और ask
spread_pctnumberस्प्रेड, %
network, contractstring; string या nullटोकन का नेटवर्क और कॉन्ट्रैक्ट पता
deposit_enabled_*, withdraw_enabled_*booleanहर एक्सचेंज पर डिपॉज़िट और विदड्रॉल खुले हैं या नहीं
volume_24h_buy, volume_24h_sellnumber या null24 घंटे का वॉल्यूम, USD
trade_url_buy, trade_url_sellstringट्रेडिंग टर्मिनल के लिंक

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 प्लान में हैं।

पैरामीटरप्रकारक्या करता हैउदाहरण
coinstringकॉइन टिकर से फ़िल्टरcoin=SCR
exchangestringCEX एक्सचेंज; कई हों तो कॉमा सेexchange=MEXC
min_spreadnumberन्यूनतम स्प्रेड, %min_spread=2
min_liquiditynumberन्यूनतम लिक्विडिटी, USDmin_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 पर बेचें; ऋण का मतलब उल्टा।

फ़ील्डप्रकारसामग्री
exchangestringCEX एक्सचेंज
cex_price, dex_pricenumberCEX और DEX पर कीमत
liquidity_usdnumberपूल की लिक्विडिटी, USD
market_cap, dex_volume_24hnumber या nullमार्केट कैप और 24 घंटे का DEX वॉल्यूम (DEX - स्पॉट)
ticker, max_position_usdstring; number या nullएक्सचेंज का जोड़ा और अधिकतम पोज़िशन, USD (DEX - फ्यूचर्स)
deposit_enabled, withdraw_enabledbooleanCEX पर डिपॉज़िट और विदड्रॉल खुले हैं या नहीं
dexscreener_url, dextools_url, gmgn_urlstring या nullDexScreener, DEXTools और GMGN के लिंक

उदाहरण के पूल में $10,544 की लिक्विडिटी है, इसलिए बड़ी खरीद उसकी कीमत हिला देगी। $100 से $100,000 तक के साइज़ का स्लिपेज, टोकन टैक्स और हर कॉन्ट्रैक्ट का हनीपॉट फ़्लैग Pro और Max प्लान में GET /orderbooks/dex-slippage से मिलता है।

क्रॉस-चेन: नेटवर्कों के पार एक टोकन

GET /arbitrage/crosschain एक टोकन की DEX कीमत की तुलना ब्लॉकचेनों के बीच करता है, Pro और Max प्लान में। पंक्ति में coin, spread_pct और एक जैसे फ़ील्ड वाले दो ऑब्जेक्ट होते हैं: buy, जहाँ टोकन सस्ता है, और sell, जहाँ महँगा है। टोकन नेटवर्कों के बीच क्रॉस-चेन ब्रिज से जाता है।

पैरामीटरप्रकारक्या करता हैउदाहरण
coinstringटोकन टिकर से फ़िल्टरcoin=WLD
chainstringनेटवर्क से फ़िल्टरchain=ethereum
min_spreadnumberन्यूनतम स्प्रेड, %min_spread=1
min_liquiditynumberन्यूनतम लिक्विडिटी, USDmin_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.chainstringउस तरफ़ का नेटवर्क
buy.pairstringDEX जोड़ा, जैसे WLD/USDC
buy.contractstringउस नेटवर्क पर कॉन्ट्रैक्ट पता
buy.price_usd, buy.liquidity_usd, buy.volume_24h_usdnumberकीमत, पूल की लिक्विडिटी और 24 घंटे का वॉल्यूम, USD
buy.pool_created_atstring या nullपूल बनने की तारीख़
buy.dexscreener_url, dextools_url, gmgn_urlstring या nullDexScreener, DEXTools और GMGN के लिंक

sell में भी यही फ़ील्ड हैं। pool_created_at UTC की तारीख़ वाली स्ट्रिंग है, API के ज़्यादातर टाइमस्टैम्प की तरह unix सेकंड नहीं, और null हो सकती है। कुछ दिन पहले बना पूल दोनों तरफ़ के कॉन्ट्रैक्ट जाँचने की वजह है: नए नेटवर्क पर उसी टिकर के पीछे कोई और टोकन हो सकता है।

स्टॉक आर्बिट्राज: स्टॉक, धातुएँ, इंडेक्स, कमोडिटी

GET /arbitrage/stocks CEX एक्सचेंजों के बीच टोकनाइज़्ड स्टॉक, धातुओं, इंडेक्स और कमोडिटी पर स्प्रेड लौटाता है और Start प्लान से ऊपर उपलब्ध है।

पैरामीटरप्रकारक्या करता हैउदाहरण
symbolstringइंस्ट्रूमेंट टिकर से फ़िल्टरsymbol=BRENT
categorystringश्रेणी: Stock, Metal, Index या Commoditycategory=Commodity
exchangestringएक्सचेंज से फ़िल्टर; कई हों तो कॉमा सेexchange=MEXC
min_spreadnumberन्यूनतम स्प्रेड, %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-spotDEX - स्पॉट
/arbitrage/dex-futuresDEX - फ्यूचर्स
/arbitrage/crosschainक्रॉसचेन
/arbitrage/stocksस्टॉक आर्बिट्राज

जोड़ों का मॉनिटर कैसे बनाएँ

  1. अपने प्लान के लिए endpoint चुनें

    ऊपर की प्लान तालिका देखें: DEX डेटासेट और क्रॉसचेन सिर्फ़ Pro और Max में हैं।

  2. सर्वर पर सेट को छोटा करें

    min_spread अपनी फ़ीस के योग से ऊपर रखें, और कम लिक्विडिटी वाले कॉइन हटाने के लिए min_volume या min_liquidity लगाएँ।

  3. चलने लायक पंक्तियाँ कोड में रखें

    स्पॉट - स्पॉट — withdraw_enabled_buy और deposit_enabled_sell। धनात्मक स्प्रेड वाला DEX - स्पॉट — deposit_enabled, ऋणात्मक वाला — withdraw_enabled। स्टॉक — symbol_on_buy और symbol_on_sell से खोजें।

  4. टोकन और ऑर्डर बुक जाँचें

    contract और network मिलाएँ, और अपने साइज़ का एक्ज़ीक्यूशन ऑर्डर बुक endpoint से निकालें।

  5. अपने प्लान की गति से पोल करें

    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 स्टॉक आर्बिट्राज जोड़ता है।