Genesis Arbitrage

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

Genesis API में प्रेडिक्शन बाज़ार और surebet: एंडपॉइंट, फ़िल्टर और फ़ील्ड

संक्षेप में

  • छह एंडपॉइंट: प्रेडिक्शन आर्बिट्राज और प्लेटफ़ॉर्म स्थिति Start प्लान से, एनालिटिक्स, स्मार्ट मनी, बड़े ट्रेड और ट्रेडर लीडरबोर्ड Pro और Max पर।
  • आर्बिट्राज बंडल ऑर्डर बुक और फ़ीस के साथ पहले से गिने आते हैं: ट्रेड साइज़, $ और % में लाभ, APR, सेटलमेंट तक के दिन और रिस्क कोड।
  • sport मोड 13 प्लेटफ़ॉर्म पर surebet देता है, सिर्फ़ मैच से पहले। अगर कोई लेग ऑड्स पर बेट है, तो profit_usd = null रहता है, क्योंकि उस बेट की स्टेक सीमा पता नहीं होती।

Genesis API प्रेडिक्शन बाज़ार का डेटा छह GET एंडपॉइंट से देता है: Polymarket, Kalshi, Limitless, Predict.fun और Opinion के बीच आर्बिट्राज बंडल, 13 प्लेटफ़ॉर्म पर surebet, प्लेटफ़ॉर्म स्थिति, एनालिटिक्स, स्मार्ट मनी, बड़े ट्रेड और ट्रेडर लीडरबोर्ड। यह प्रेडिक्शन आर्बिट्राज, एनालिटिक्स और स्मार्ट मनी पेजों का ही डेटा है, JSON में। इस पर बॉट, डैशबोर्ड या अलर्ट बनाएं; ट्रेड और बेट आप खुद प्लेटफ़ॉर्म पर लगाते हैं।

एंडपॉइंट और प्लान

एंडपॉइंटक्या लौटाता हैAPI प्लान
/predictions/arbitrageआर्बिट्राज बंडल और surebetStart, Pro, Max; llm और sport मोड — Pro, Max
/predictions/platformsप्लेटफ़ॉर्म स्थितिStart, Pro, Max
/predictions/analyticsKPI, कीमत की चाल, मनी फ़्लोPro, Max
/predictions/smart-moneyबड़े ट्रेड, व्हेल, इनसाइडर पैटर्नPro, Max
/predictions/tradesPolymarket ट्रेड टेपPro, Max
/predictions/tradersPnL के अनुसार शीर्ष 300 Polymarket ट्रेडरPro, Max

Trial पर छहों 403 plan_restricted लौटाते हैं; Start पर mode=llm और mode=sport वाले रिक्वेस्ट भी यही लौटाते हैं। रिस्पॉन्स का फ़ॉर्मैट रिस्पॉन्स और त्रुटियां गाइड में है, कोटा सीमाएं गाइड में।

प्रेडिक्शन आर्बिट्राज: मोड

mode पैरामीटर तय करता है कि /predictions/arbitrage कौन-से बंडल लौटाए।

modeक्या मिलता हैkindप्लान
exactदो प्लेटफ़ॉर्म पर वही इवेंट, डिफ़ॉल्टcrossStart, Pro, Max
dutchएक प्लेटफ़ॉर्म पर एक इवेंट के नतीजों का सेटdutchStart, Pro, Max
llmAI से जांचे गए इवेंट जोड़ेcrossPro, Max
sportमैचों पर surebetsportPro, Max

लाभ पहले से प्लेटफ़ॉर्म की ऑर्डर बुक और फ़ीस के साथ गिना गया है। कम से कम 1% लाभ वाले और 30 दिन में सेटल होने वाले exact बंडल का रिक्वेस्ट:

curl -G "https://api.genesisarbitrage.com/v1/predictions/arbitrage" \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX" \
  -d mode=exact -d min_profit_pct=1 -d max_days=30

फ़िल्टर

पैरामीटरटाइपक्या करता है
modestringexact (डिफ़ॉल्ट), dutch, llm या sport
categorystringश्रेणी, जैसी category फ़ील्ड में है
platformstringकम से कम एक लेग इस प्लेटफ़ॉर्म पर; कई हों तो कॉमा से अलग करें
min_profit_pctnumberन्यूनतम लाभ, %
min_profit_usdnumberन्यूनतम लाभ, $; जिन पंक्तियों में profit_usd = null है वे छूट जाती हैं
min_aprnumberन्यूनतम APR, %
max_daysnumberसेटलमेंट तक अधिकतम दिन
sport, leaguestringखेल और लीग, mode=sport के लिए

फ़िल्टर वैकल्पिक हैं और साथ में चल सकते हैं। प्लेटफ़ॉर्म वैसे लिखें जैसा legs[].platform में है: polymarket, kalshi, fonbet। अज्ञात mode पर 400 bad_request मिलता है।

बंडल और उसके लेग

उदाहरण के लिए: दस्तावेज़ से mode=exact की एक पंक्ति, छोटी की हुई।

{
  "id": "x:exact:kalshi:KXFRENCHPRES-27-JCAS~polymarket:0x8c1f…",
  "kind": "cross",
  "match": "exact",
  "title": "Will Jean Castex win the 2027 French presidential…",
  "category": "Elections",
  "ends_at": 1843308000,
  "days_left": 562.87,
  "size_usd": 107175.08,
  "fees_usd": 28.08,
  "profit_usd": 153.69,
  "profit_pct": 0.14,
  "apr_pct": 0.1,
  "shares": 107356.85,
  "risks": ["rules_differ", "end_mismatch"],
  "legs": [
    {
      "platform": "polymarket",
      "side": "yes",
      "outcome": "Jean Castex",
      "price_avg": 0.0013,
      "cost_usd": 140.3,
      "fee_usd": 5.6,
      "url": "https://polymarket.com/event/next-french-presidential-…"
    },
    {
      "platform": "kalshi",
      "side": "no",
      "outcome": "No",
      "price_avg": 0.997,
      "cost_usd": 107034.78,
      "fee_usd": 22.48,
      "url": "https://kalshi.com/events/KXFRENCHPRES-27"
    }
  ]
}
फ़ील्डअर्थ
id, first_seen, updated_atस्थिर id, बंडल कब दिखा और कब अपडेट हुआ
kind, matchcross, dutch या sport; match है exact, llm या sport
title, categoryइवेंट या बाज़ार और उसकी श्रेणी
ends_at, days_left, starts_atसेटलमेंट का समय, सेटलमेंट तक के दिन, मैच की शुरुआत
size_usd, fees_usd, shares$ में ट्रेड साइज़ और फ़ीस, शेयरों की संख्या
profit_usd, profit_pct, apr_pct$ और % में लाभ, APR; एक दिन से कम पर apr_pct null होता है
edge_cents, risksप्रति शेयर सेंट में कीमत का अंतर, रिस्क कोड
legs[].platform, market, outcomeलेग का प्लेटफ़ॉर्म, बाज़ार और नतीजा
legs[].sideyes या no — क्या ख़रीदना है; bet — ऑड्स पर बेट
legs[].price_best, price_avg, price_worstबुक से गुज़रने पर सबसे अच्छी, औसत और सबसे बुरी कीमत
legs[].shares, cost_usd, fee_usd, urlलेग के शेयर, लागत, फ़ीस और बाज़ार का लिंक

लेग की कीमत $1 का अंश होती है: नतीजा जीते तो शेयर $1 लौटाता है, इसलिए 0.997 यानी 99.7 सेंट। अगर दोनों प्लेटफ़ॉर्म एक ही तरह सेटल करें, तो कुछ भी हो एक लेग जीतता है, और shares वह रकम है जो आपको मिलती है। rules_differ का मतलब है कि प्लेटफ़ॉर्म के सेटलमेंट नियम अलग हो सकते हैं; end_mismatch का मतलब है कि सेटलमेंट की तारीख़ें अलग हैं।

उदाहरण में 107,356.85 − 107,175.08 − 28.08 = $153.69 लाभ है, यानी 153.69 / 107,203.16 = 0.14%। पैसा सेटलमेंट तक 562.87 दिन फँसा रहता है, इसलिए सालाना दर 0.14 × 365 / 562.87 ≈ 0.1% आती है। max_days फ़िल्टर ऐसे बंडल हटा देता है।

sport मोड: surebet

sport पंक्ति एक मैच का एक बाज़ार है: अलग-अलग प्लेटफ़ॉर्म पर 2 या 3 लेग, जो मिलकर उसके सभी नतीजे कवर करते हैं। प्लेटफ़ॉर्म 13 हैं: Polymarket, Kalshi, Predict.fun और 10 बेटिंग प्लेटफ़ॉर्म — Fonbet, Betcity, Olimpbet, Marathon, 5051X, Melbet, Winline, BC.Game, EGB और Dafa Sports। सिर्फ़ मैच से पहले: मैच शुरू होते ही surebet सूची से हट जाता है।

उदाहरण के लिए: दस्तावेज़ से mode=sport की एक पंक्ति, दोबारा गिनी गई कीमतों के साथ।

{
  "id": "s:8812:RT:TOT:2.5:",
  "kind": "sport",
  "title": "Arsenal — Chelsea",
  "sport": "soccer",
  "league": "Premier League",
  "teams": ["Arsenal", "Chelsea"],
  "market_type": "TOT",
  "period": "RT",
  "line": 2.5,
  "starts_at": 1794700800,
  "size_usd": 1000,
  "profit_usd": null,
  "profit_pct": 2.39,
  "legs": [
    {
      "platform": "polymarket",
      "side": "yes",
      "outcome": "Over 2.5",
      "covers": ["O"],
      "price_avg": 0.505,
      "odds": null,
      "stake_unit": 0.505,
      "currency": "USD"
    },
    {
      "platform": "fonbet",
      "side": "bet",
      "outcome": "Under 2.5",
      "covers": ["U"],
      "odds": 2.12,
      "stake_unit": 0.471698,
      "currency": "RUB"
    }
  ]
}
फ़ील्डअर्थ
sport, league, teams, flagsखेल, लीग, टीमें, मैच के टैग
market_typeWIN — नतीजा, HCP — हैंडिकैप, TOT — टोटल, BTTS — दोनों टीमें स्कोर करें, CS — सही स्कोर
period, line, scoreसेटलमेंट की अवधि, हैंडिकैप या टोटल की लाइन, CS के लिए स्कोर
legs[].coversलेग कौन-से नतीजे कवर करता है: O — ओवर, U — अंडर
legs[].oddsडेसिमल ऑड्स; YES या NO ख़रीद के लिए null
legs[].stake_unitस्टेक का हिस्सा: जीतने पर $1 पाने के लिए लेग पर कितना लगाना है, फ़ीस समेत
legs[].currencyप्लेटफ़ॉर्म की मुद्रा

ऑड्स पर बेट के लिए stake_unit = 1 / odds: 1 / 2.12 = 0.471698। लेग के स्टेक यूनिट का योग 0.505 + 0.471698 = 0.976698 है, जो 1 से कम है, इसलिए लाभ 1 / 0.976698 − 1 = 2.39% है। अपनी रकम बांटने के लिए leg stake = amount × stake_unit / Σ stake_unit लें।

size_usd प्रेडिक्शन प्लेटफ़ॉर्म पर ख़रीद की वह रकम है जिसे उनकी ऑर्डर बुक झेल सकती हैं। 0.505 पर $1,000 से "Over 2.5" के 1,000 / 0.505 ≈ 1,980.2 YES शेयर मिलते हैं। "Under 2.5" से उतना ही लौटाने के लिए Fonbet की बेट 1,980.2 × 0.471698 ≈ $934.06 है।

Fonbet रूबल में बेट लेता है (currency = RUB): रकम अपने भाव से बदलें, क्योंकि एक्सचेंज profit_pct में शामिल नहीं है। यहां profit_usd null है, क्योंकि बेटिंग प्लेटफ़ॉर्म बेट की स्टेक सीमा प्रकाशित नहीं करता।

प्लेटफ़ॉर्म स्थिति

/predictions/platforms दिखाता है कि आर्बिट्राज डेटा कितना ताज़ा है। इसमें कोई पैरामीटर नहीं है; data में दो सूचियां हैं:

{
  "platforms": [
    {
      "platform": "kalshi",
      "mode": "rest",
      "quotes_at": 1794675858,
      "full_scan_at": 1794675012,
      "markets": 26187,
      "hot_markets": 188
    }
  ],
  "bookmakers": [
    {
      "bookmaker": "fonbet",
      "title": "Fonbet",
      "ok": true,
      "events": 1840,
      "matched_events": 212,
      "updated_at": 1794675855,
      "currency": "RUB"
    }
  ]
}

जिन बंडलों में कोई प्लेटफ़ॉर्म down में है या ok = false है, उन्हें छोड़ देना बेहतर है: उनकी कीमतें बदल चुकी हो सकती हैं।

एनालिटिक्स, स्मार्ट मनी, ट्रेड और ट्रेडर

Pro और Max के चार एंडपॉइंट एनालिटिक्स और स्मार्ट मनी गाइड की स्क्रीन को दोहराते हैं।

एंडपॉइंटपैरामीटरअंदर क्या है
/predictions/analyticsकोई नहींKPI, 1h और 24h में कीमत की चाल, मनी फ़्लो, जल्द सेटल होने वाले बाज़ार, नए बाज़ार
/predictions/smart-moneyकोई नहींKPI, मनी फ़्लो, insiders, concentration, smart_vs_price
/predictions/tradesperiod, wallet, category, side, min_usd, insiderPolymarket ट्रेड, सबसे नए पहले
/predictions/tradersperiod: 30d (डिफ़ॉल्ट), 7d, allPnL के अनुसार शीर्ष 300 Polymarket ट्रेडर

insider लेबल वॉलेट के व्यवहार का पैटर्न बताता है और कुछ साबित नहीं करता: अनुभवी ट्रेडर का नया पता भी इसी तरह ट्रेड कर सकता है।

ट्रेड टेप के पैरामीटर; period सीमा तय करता है:

पैरामीटरटाइपक्या करता है
periodstringlive (डिफ़ॉल्ट) — $1,000 से ट्रेड, स्मार्ट वॉलेट के लिए $100 से; today और 7d — $5,000 से टेकर
walletstringएक वॉलेट के ट्रेड
categorystringबाज़ार की श्रेणी
sidestringbuy या sell
min_usdnumberन्यूनतम ट्रेड रकम, $
insiderbooleantrue — सिर्फ़ insider लेबल वाले ट्रेड
curl -G "https://api.genesisarbitrage.com/v1/predictions/trades" \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX" \
  -d period=today -d side=buy -d min_usd=10000
{
  "ts": 1794675812,
  "wallet": "0x3a1c…f09e",
  "tags": ["whale", "smart"],
  "title": "Will Bitcoin reach $150k in 2026?",
  "outcome": "No",
  "side": "buy",
  "price": 0.82,
  "shares": 30487.8,
  "usd": 25000,
  "role": "taker",
  "insider": false,
  "bid_now": 0.81,
  "ask_now": 0.83
}

usd = price × shares: 0.82 × 30,487.8 ≈ 25,000। bid_now और ask_now नतीजे की मौजूदा कीमतें हैं: इस ट्रेड के पीछे अभी चलने में 0.83 लगता है, यानी ट्रेडर के दिए भाव से 1 सेंट ज़्यादा।

/predictions/traders पूरे समय, 30 और 7 दिन का PnL (pnl_usd), roi_pct, resolved में से won और pnl_series स्पार्कलाइन देता है। लीडरबोर्ड का कोई पता ट्रेड टेप के wallet में डालें।

कैसे इस्तेमाल करें

  1. अपना प्लान और प्लेटफ़ॉर्म जांचें

    /account/usage आपका प्लान दिखाता है, /predictions/platforms कोट कितने ताज़ा हैं।

  2. फ़िल्टर के साथ बंडल मांगें

    min_profit_pct और max_days शोर और दूर की सेटलमेंट वाले बंडल घटाते हैं।

  3. रिस्क और नियम जांचें

    rules_differ हो तो दोनों प्लेटफ़ॉर्म के सेटलमेंट नियम पढ़ें।

  4. अपने प्लान की ताज़गी से तेज़ पोल न करें

    कम से कम meta.freshness_sec का अंतराल रखें और ETag को If-None-Match में लौटाएं: 304 रिस्पॉन्स कोटा नहीं खर्चता।

  5. ट्रेड खुद करें

    legs[].url से बाज़ार खोलें और उसकी ऑर्डर बुक में कीमत जांचें।

वही exact रिक्वेस्ट Python में:

import os
from datetime import datetime, timezone

import requests

API = "https://api.genesisarbitrage.com/v1"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}
params = {"mode": "exact", "min_profit_pct": 1, "max_days": 30}

r = requests.get(f"{API}/predictions/arbitrage", headers=HEADERS,
                 params=params, timeout=10)
if r.status_code == 403:
    raise SystemExit("एंडपॉइंट या मोड आपके API प्लान में शामिल नहीं है")
r.raise_for_status()
body = r.json()
ts = datetime.fromtimestamp(body["meta"]["updated_at"], timezone.utc)
print(f"बंडल: {body['meta']['count']}, डेटा का समय {ts:%H:%M:%S} UTC")

for b in body["data"]:
    print(f"{b['profit_pct']:.2f}% · ${b['profit_usd']:.2f} · "
          f"{b['days_left']:.0f} दिन · {b['title'][:40]}")
    for leg in b["legs"]:
        print(f"   {leg['platform']}: {leg['side']} "
              f"{leg['outcome']} कीमत {leg['price_avg']}")
    if b["risks"]:
        print("   रिस्क:", ", ".join(b["risks"]))

साइट पर यही बंडल प्रेडिक्शन आर्बिट्राज और Sport मोड गाइड में हैं; प्लेटफ़ॉर्म के आधिकारिक API — Polymarket और Kalshi API और API से बेटिंग ऑड्स लेखों में।

सवाल और जवाब

क्या Genesis API से कॉन्ट्रैक्ट ख़रीद या बेट लगा सकता हूं?

नहीं। Genesis API सिर्फ़ डेटा पढ़ता है और कोई ऑर्डर नहीं लगाता: ट्रेड और बेट आप खुद प्लेटफ़ॉर्म पर लगाते हैं।

surebet में profit_usd null क्यों है?

कम से कम एक लेग ऑड्स पर बेट है, और प्लेटफ़ॉर्म उसकी स्टेक सीमा प्रकाशित नहीं करता। लाभ का प्रतिशत पता है; हर लेग की रकम stake_unit से निकालें।

क्या API में लाइव surebet हैं?

नहीं, सिर्फ़ मैच से पहले वाले। लाइव में जोखिम ज़्यादा क्यों है, यह प्रीमैच बनाम लाइव लेख में है।

surebet के लिए कौन-सा प्लान चाहिए?

Pro या Max: Start पर mode=sport 403 plan_restricted लौटाता है। कीमतें Genesis API मूल्य पेज पर हैं।