Genesis Arbitrage

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

Genesis API के order book endpoint: execution price, ऑर्डर-बुक Δ, बुक, इतिहास और DEX

संक्षेप में

  • API Pro और Max प्लान के छह order book endpoint वही डेटा देते हैं जो साइट «ऑर्डर से Δ» कॉलम, «ऑर्डर बुक» विंडो और Genesis Charts में दिखाती है।
  • Execution price $500, $1,000, $2,500, $5,000 या $10,000 के मार्केट ट्रेड की औसत कीमत है; null का मतलब है कि उस वॉल्यूम के लिए बुक बहुत पतली है।
  • बुक एक्सचेंज से 5–20 सेकंड पीछे रहती हैं: age_sec और stale देखें, और ट्रेड से पहले एक्सचेंज टर्मिनल में बुक जाँचें।

Genesis API का order book API छह endpoint है, जो दिखाते हैं कि तय आकार के ट्रेड पर स्प्रेड का कितना हिस्सा बचता है। ये किसी वॉल्यूम का execution price, आर्बिट्राज पंक्तियों का ऑर्डर-बुक Δ, ऑर्डर बुक और उसकी depth, slippage इतिहास और DEX slippage लौटाते हैं — वही डेटा जो साइट के «ऑर्डर से Δ» कॉलम और Genesis Charts में है।

छह order book endpoint

Endpointक्या लौटाता हैज़रूरीडॉक्स
/orderbooks/execहर मार्केट पर एक वॉल्यूम की खरीद और बिक्री कीमतvolumeनिष्पादन कीमतें
/orderbooks/spreads/{dataset}आर्बिट्राज डेटासेट में एक कॉइन की पंक्तियों का ऑर्डर-बुक Δcoinऑर्डर-बुक Δ
/orderbooks/bookएक मार्केट की बुक: 10 स्तर, दीवारें, depth, आयुexchange, market, coinबाज़ार ऑर्डर बुक
/orderbooks/coin/{coin}हर एक्सचेंज और मार्केट पर कॉइन की बुकपाथ में coinकॉइन ऑर्डर बुक
/orderbooks/exec-historyslippage इतिहास, एक रिक्वेस्ट में 8 मार्केट तकkeys, intervalनिष्पादन इतिहास
/orderbooks/dex-slippageहर कॉन्ट्रैक्ट का slippage, टैक्स और honeypot फ़्लैग—DEX स्लिपेज

छहों API प्लान Pro ($100 प्रति माह) और Max ($200) में शामिल हैं; Trial और Start पर 403 plan_restricted मिलता है। /orderbooks/exec में और इतिहास के keys पैरामीटर में मार्केट Exchange|market|COIN रूप में लिखा जाता है, जैसे Binance|spot|BTC। नीचे के जवाब के उदाहरण data फ़ील्ड को छोटा करके दिखाते हैं।

Order book डेटा का परिचय order book API लेख में है।

किसी वॉल्यूम का execution price

Execution price वह औसत कीमत है जिस पर तय आकार का मार्केट ऑर्डर बुक से गुज़रता है: खरीद asks लेती है, बिक्री bids पर लगती है, इसलिए यह ट्रेड द्वारा खाए गए ऑर्डरों का VWAP है। /orderbooks/exec इसे ग्रिड के एक वॉल्यूम पर हर मार्केट के लिए लौटाता है।

पैरामीटरप्रकारक्या करता है
volumeसंख्याUSD में वॉल्यूम: 500, 1000, 2500, 5000 या 10000, ज़रूरी
exchangeस्ट्रिंगएक्सचेंज से फ़िल्टर; कई के लिए कॉमा से अलग करें
marketस्ट्रिंगspot या futures
coinस्ट्रिंगकॉइन टिकर, जैसे BTC
curl "https://api.genesisarbitrage.com/v1/orderbooks/exec?volume=1000" \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
  "volume": 1000,
  "markets": {
    "Binance|spot|BTC": [96021.5, 96010.2],
    "ByBit|futures|BTC": [96030.1, 96018.7],
    "Ourbit|spot|SHELL": [0.10418, null],
    …
  }
}

हर मार्केट key का मान [खरीद कीमत, बिक्री कीमत] है। कीमत की जगह null का मतलब है कि उस वॉल्यूम के लिए बुक बहुत पतली है: उदाहरण में Ourbit पर SHELL के bids $1,000 की बिक्री नहीं सोख सकते। फ़िल्टर के बिना जवाब में सारे मार्केट होते हैं, इसलिए एक कॉइन चाहिए तो coin दें।

ऑर्डर-बुक Δ: बुक से गुज़रने के बाद का स्प्रेड

ऑर्डर-बुक Δ आर्बिट्राज पंक्ति का वह स्प्रेड है जो तय वॉल्यूम के लिए ऑर्डर बुक से दोबारा निकाला गया हो। /orderbooks/spreads/{dataset} चुने गए डेटासेट में एक कॉइन की हर पंक्ति लेता है और हर एक में order_delta ऑब्जेक्ट जोड़ता है, साइट के कॉलम वाले ही सूत्रों से।

पैरामीटरप्रकारक्या करता है
{dataset}स्ट्रिंग, पाथ मेंspot-spot, spot-futures, futures-futures, dex-spot या dex-futures
coinस्ट्रिंगकॉइन टिकर, ज़रूरी
volumeसंख्याडिफ़ॉल्ट 0 — बुक की सबसे अच्छी कीमतें; या 500, 1000, 2500, 5000, 10000

CEX जोड़ों में खरीद exchange_buy के asks से गुज़रती है और बिक्री exchange_sell के bids में जाती है। order_delta में buy_price और sell_price होते हैं, और नतीजा कभी पंक्ति के spread_pct से ऊपर नहीं जाता।

DEX पंक्तियों में स्प्रेड का चिह्न CEX की तरफ़ तय करता है: spread_pct ≥ 0 हो तो टोकन CEX bids में बेचा जाता है, ऋणात्मक हो तो asks से खरीदा जाता है। order_delta में side और cex_price, यानी CEX का execution price, होता है; अगर बुक से गुज़रने के बाद चिह्न पलट जाए तो Δ 0 होता है।

status फ़ील्ड: ok — गणना हुई, no_book — बुक नहीं है, exhausted — बुक वॉल्यूम नहीं भर पाई।

एक काल्पनिक उदाहरण: कॉइन XYZ, MEXC पर 2.000 में खरीद, Gate पर 2.016 में बिक्री, पंक्ति का स्प्रेड 0.8%। $5,000 के लिए ऑर्डर-बुक Δ का अनुरोध:

curl -G \
  "https://api.genesisarbitrage.com/v1/orderbooks/spreads/spot-spot" \
  -d coin=XYZ -d volume=5000 \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
  "coin": "XYZ",
  "exchange_buy": "MEXC",
  "exchange_sell": "Gate",
  "market_buy": "spot",
  "market_sell": "spot",
  "price_buy": 2.0,
  "price_sell": 2.016,
  "ask_buy": 2.001,
  "bid_sell": 2.015,
  "spread_pct": 0.8,
  "order_delta": {
    "volume": 5000,
    "buy_price": 2.004,
    "sell_price": 2.01,
    "spread_pct": 0.2994,
    "status": "ok"
  }
}

पंक्ति के बाकी फ़ील्ड /arbitrage/spot-spot जैसे हैं। पंक्ति का स्प्रेड: (2.016 − 2.000) / 2.000 × 100 = 0.8%।

$5,000 पर MEXC की बुक से खरीद का औसत 2.004 आता है और Gate की बुक में बिक्री 2.010 पर होती है: (2.010 − 2.004) / 2.004 × 100 ≈ 0.2994%। इस आकार पर 0.8% में से लगभग 0.3% बचता है — फ़ीस और ट्रांसफ़र से पहले करीब $15: 5,000 × 0.002994 ≈ 14.97।

Python उदाहरण: बुक से पहले और बाद का स्प्रेड

स्क्रिप्ट Spot – Spot डेटासेट में BTC के लिए $5,000 पर पंक्ति का स्प्रेड और बुक के बाद का स्प्रेड साथ-साथ छापती है। key पर्यावरण चर GENESIS_API_KEY से आती है; 429 और 503 पर स्क्रिप्ट Retry-After सेकंड रुकती है।

import os
import time
import requests

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


def get(path, params):
    for _ in range(3):
        r = requests.get(BASE + path, headers=HEADERS,
                         params=params, timeout=15)
        if r.status_code in (429, 503):
            # rate limit या डेटा का दोबारा बनना
            time.sleep(int(r.headers.get("Retry-After", "5")))
            continue
        r.raise_for_status()
        return r.json()["data"]
    raise RuntimeError("API व्यस्त है, बाद में फिर कोशिश करें")


rows = get("/orderbooks/spreads/spot-spot",
           {"coin": "BTC", "volume": 5000})
for row in rows:
    od = row["order_delta"]
    if od["status"] == "ok":
        after = f'{od["spread_pct"]:.4f}%'
    else:
        after = od["status"]  # no_book या exhausted
    print(f'{row["exchange_buy"]} → {row["exchange_sell"]}: '
          f'{row["spread_pct"]}% → {after}')

लूप में meta.freshness_sec सेकंड में एक बार से ज़्यादा poll न करें: Pro पर 10 सेकंड, Max पर 5 सेकंड। कोटा और लिमिट Genesis API की लिमिट गाइड में हैं।

बाज़ार ऑर्डर बुक और कॉइन ऑर्डर बुक

/orderbooks/book एक मार्केट की बुक लौटाता है, साइट की «ऑर्डर बुक» विंडो की तरह। तीन ज़रूरी पैरामीटर मार्केट तय करते हैं: exchange (अक्षर-भेद नहीं), market (spot या futures) और coin। /orderbooks/coin/{coin} कॉइन के हर एक्सचेंज और मार्केट के लिए इन्हीं ऑब्जेक्ट की ऐरे लौटाता है।

curl -G "https://api.genesisarbitrage.com/v1/orderbooks/book" \
  -d exchange=Binance -d market=spot -d coin=BTC \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
  "exchange": "Binance",
  "market": "spot",
  "coin": "BTC",
  "book_ts": 1794675858,
  "age_sec": 6,
  "stale": false,
  "source": "ws",
  "depth_limited": false,
  "levels_bid": 500,
  "levels_ask": 500,
  "best_bid": 96015.9,
  "best_ask": 96016,
  "bids": [[96015.9, 412300.5], [96015.8, 51020.3], …],
  "asks": [[96016, 388120.2], [96016.1, 20410.7], …],
  "walls_bid": [[95900, 2410000]],
  "walls_ask": [[96500, 1980000]],
  "depth_bid_usd": 61234567,
  "depth_ask_usd": 58765432
}
फ़ील्डमतलब
best_bid, best_askसबसे अच्छा bid और ask
bids, asksऊपर के 10 स्तर: [कीमत, USD में राशि]
walls_bid, walls_askसबसे बड़ी दीवारें: [कीमत, USD में राशि]
depth_bid_usd, depth_ask_usdसबसे अच्छी कीमत के ±50% के भीतर हर तरफ़ की depth, USD में
book_ts, age_sec, staleबुक का समय और सेकंड में उसकी आयु; stale — 30 सेकंड से पुरानी
source, depth_limitedबुक का स्रोत (ws या rest) और सीमित-depth फ़्लैग

depth_bid_usd और depth_ask_usd में market depth बुक की एक तरफ़ पड़े ऑर्डरों के डॉलर हैं: उदाहरण में Binance पर BTC के सबसे अच्छे ask से +50% के भीतर लगभग $58.8M के asks हैं।

depth_limited: true हो तो एक्सचेंज अधूरी बुक प्रकाशित करता है और बड़ा वॉल्यूम पूरा न भर पाए। उस एक्सचेंज, मार्केट और कॉइन की बुक न हो तो 404 मिलता है।

निष्पादन इतिहास

/orderbooks/exec-history Genesis Charts का slippage इतिहास है: ग्रिड के हर वॉल्यूम पर निष्पादन की लागत, बुक के मध्य से बेसिस पॉइंट में (1 bp = 0.01%)। एक रिक्वेस्ट में keys में कॉमा से अलग 8 मार्केट तक दिए जा सकते हैं; interval ज़रूरी है।

intervalपॉइंट का अंतराल360 पॉइंट कितना कवर करते हैं
1m1 मिनट6 घंटे
15m15 मिनट3.75 दिन
1h1 घंटा15 दिन
1d1 दिनलगभग एक साल

डेटा 6 सितंबर 2026 से जमा हो रहा है, इसलिए दैनिक सीरीज़ उसी तारीख़ से भरी है।

curl -G "https://api.genesisarbitrage.com/v1/orderbooks/exec-history" \
  --data-urlencode "keys=Binance|spot|BTC,ByBit|futures|BTC" \
  -d interval=1h \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
  "interval": "1h",
  "step_sec": 3600,
  "points": 360,
  "volumes_usd": [500, 1000, 2500, 5000, 10000],
  "last_bucket_ts": 1794672000,
  "series": {
    "Binance|spot|BTC": {
      "buy": [[1, 1, 2, …], [1, 2, 2, …], [2, 3, 4, …],
              [3, 4, 6, …], [5, 7, 9, …]],
      "sell": [[-1, -1, -2, …], …]
    },
    "ByBit|futures|BTC": { … }
  }
}

buy और sell में पाँच-पाँच सीरीज़ हैं, volumes_usd के हर वॉल्यूम की एक, और हर सीरीज़ में सबसे पुराने से नए तक 360 मान। आख़िरी पॉइंट last_bucket_ts का है, और पॉइंट i last_bucket_ts − (points − 1 − i) × step_sec का। खरीद के मान धनात्मक और बिक्री के ऋणात्मक हैं: ट्रेड की औसत कीमत बुक के मध्य से ऊपर और नीचे रहती है।

सीरीज़ [5, 7, 9, …] $10,000 की खरीद है: उसके पहले पॉइंट 5–9 bp, यानी मध्य से 0.05–0.09% ऊपर, पड़ते हैं। सीरीज़ में null का मतलब डेटा नहीं है या बुक नहीं भरी; मार्केट ऑब्जेक्ट की जगह null का मतलब अज्ञात key है।

DEX slippage

/orderbooks/dex-slippage सेटअप के DEX हिस्से का ब्योरा देता है: $100 से $100,000 तक खरीद और बिक्री का slippage, टोकन टैक्स और हर कॉन्ट्रैक्ट का honeypot फ़्लैग — साइट की DEX तालिका के कॉलम जैसा ही। फ़िल्टर: contract (कई के लिए कॉमा से) और network।

curl -G "https://api.genesisarbitrage.com/v1/orderbooks/dex-slippage" \
  -d contract=0x6982508145454ce325ddbe47a25d4ec3d2311933 \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
  "sizes_usd": [100, 500, 1000, 2500, 5000, 10000, 20000, 50000,
                100000],
  "contracts": [
    {
      "contract": "0x6982508145454ce325ddbe47a25d4ec3d2311933",
      "network": "ETH",
      "tax_buy_pct": 0,
      "tax_sell_pct": 0,
      "honeypot": "no",
      "slippage_buy_pct": [0.31, 0.33, 0.36, 0.44, 0.58, 0.86,
                           1.41, 3.12, 6.05],
      "slippage_sell_pct": [0.31, 0.34, 0.37, 0.46, 0.61, 0.9,
                            1.5, 3.3, 6.4],
      "updated_at": 1794671040
    }
  ]
}

Slippage ऐरे sizes_usd ग्रिड के क्रम में हैं: उदाहरण में $5,000 की खरीद पर 0.58% और $100,000 की खरीद पर 6.05% slippage है। ऐरे में null का मतलब है कि उस आकार के लिए पूल में लिक्विडिटी नहीं है।

tax_buy_pct और tax_sell_pct टोकन का खरीद और बिक्री टैक्स हैं, %; null का मतलब स्रोत नहीं है, 0% नहीं। honeypot: no; suspect — स्रोत असहमत हैं; yes — बिक्री असंभव हो सकती है।

सेटअप को बुक से कैसे जाँचें

  1. आर्बिट्राज पंक्ति चुनें

    /arbitrage/spot-spot या किसी और डेटासेट में सेटअप ढूँढें — आर्बिट्राज endpoint देखें। कॉइन, एक्सचेंज और spread_pct नोट करें।

  2. बुक से स्प्रेड दोबारा निकालें

    उसी कॉइन और अपने ट्रेड के आकार के साथ /orderbooks/spreads/spot-spot माँगें और spread_pct की तुलना order_delta.spread_pct से करें।

  3. फ़्रेशनेस और depth जाँचें

    दोनों legs के लिए /orderbooks/book बुलाएँ: age_sec, stale और depth_limited बताते हैं कि आँकड़ों पर भरोसा करें या नहीं, और दीवारें दिखाती हैं कि कीमत कहाँ अटक सकती है।

  4. इतिहास से तुलना करें

    /orderbooks/exec-history दिखाता है कि यह slippage इस मार्केट के लिए सामान्य है या नहीं: 1m 6 घंटे और 1h 15 दिन कवर करता है।

  5. DEX leg का टैक्स जाँचें

    DEX – Spot और DEX – Futures सेटअप के लिए पंक्ति के कॉन्ट्रैक्ट पर /orderbooks/dex-slippage माँगें: slippage, टैक्स और honeypot।

सवाल और जवाब

ऑर्डर-बुक Δ सामान्य स्प्रेड से कैसे अलग है?

पंक्ति का spread_pct एक्सचेंजों की आख़िरी कीमतें लेता है; ऑर्डर-बुक Δ तय वॉल्यूम पर मार्केट ट्रेड की औसत कीमतें लेता है। दोनों का अंतर वही है जो बुक खा जाती है।

कीमत की जगह null क्यों मिलता है?

/orderbooks/exec में उस वॉल्यूम के लिए बुक में ऑर्डर कम हैं; ऑर्डर-बुक Δ में यही स्थिति exhausted स्टेटस है। निष्पादन इतिहास में null का मतलब उस पॉइंट पर डेटा नहीं है, और DEX slippage में पूल में लिक्विडिटी नहीं है।

क्या $10,000 से ऊपर का निष्पादन निकाला जा सकता है?

/orderbooks/exec और ऑर्डर-बुक Δ का ग्रिड $500 से $10,000 तक तय है। बड़े आकार के लिए /orderbooks/book में depth और दीवारें देखें; DEX leg के लिए /orderbooks/dex-slippage $100,000 तक जाता है।