Genesis Arbitrage

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

आर्बिट्राज बेटिंग के लिए Sports Odds API: इवेंट, ऑड्स और सरबेट API से

संक्षेप में

  • Sports odds API इवेंट, मार्केट और हर स्पोर्ट्सबुक के ऑड्स लौटाती है, आख़िरी अपडेट के समय के साथ। डेसिमल ऑड्स की इम्प्लाइड प्रोबेबिलिटी 1/k होती है, और प्रेडिक्शन मार्केट में YES कॉन्ट्रैक्ट का भाव वही प्रोबेबिलिटी डॉलर में है।
  • सरबेट तब बनता है जब किसी मार्केट के सभी नतीजों पर सर्वोत्तम ऑड्स का 1/k जोड़ 1 से कम हो, और हर स्टेक 1/k के अनुपात में होता है। ज़्यादातर गलतियाँ मैचिंग में होती हैं: मैच, मार्केट, अवधि और लाइन हर प्लेटफ़ॉर्म पर एक ही होनी चाहिए।
  • Pro और Max प्लान के mode=sport में Genesis API 13 प्लेटफ़ॉर्म के प्री-मैच सरबेट हर लेग के stake_unit के साथ लौटाती है। इनमें profit_usd null होता है, क्योंकि स्पोर्ट्सबुक की स्टेक सीमा पता नहीं होती।

Sports odds API, जिसे sports betting API भी कहते हैं, प्रोग्राम को बेटिंग लाइन देती है: इवेंट, मार्केट और हर स्पोर्ट्सबुक के ऑड्स, हर भाव के आख़िरी अपडेट के समय के साथ। इसी डेटा से प्रोग्राम प्लेटफ़ॉर्म के बीच भावों की तुलना करता है और सरबेट ढूँढता है — मैच के सभी नतीजों पर लगाए दांव, जो किसी भी नतीजे पर मुनाफ़े में खत्म होते हैं, बशर्ते हर दांव स्वीकार हो और एक ही नियमों से सेटल हो। यही आर्बिट्राज बेटिंग है, और Genesis API /predictions/arbitrage endpoint से mode=sport के साथ 13 प्लेटफ़ॉर्म के तैयार सरबेट देती है।

Sports odds API क्या लौटाती है

प्रोवाइडर फ़ील्ड के नाम अलग रखते हैं, पर odds API लाइन को पाँच स्तरों में बताती है। अवधि और लाइन के बिना दो ऑड्स की तुलना नहीं हो सकती, और समय के बिना पता नहीं चलता कि भाव अब भी चल रहा है या नहीं। दाईं ओर का कॉलम उदाहरण के लिए है।

स्तरइसमें क्या होता हैउदाहरण
इवेंटखेल, प्रतियोगिता, टीमें, शुरुआतफ़ुटबॉल, Bundesliga, Bayern — Dortmund
मार्केटदांव का प्रकार, अवधि, लाइनटोटल 2.5, रेगुलर टाइम
नतीजादांव किस पर है2.5 से ज़्यादा
भावहर स्पोर्ट्सबुक के ऑड्सFonbet @1.95, Winline @2.02
समयभाव कब अपडेट हुआ12 सेकंड पहले

ऑड्स डेसिमल, फ़्रैक्शनल या अमेरिकन रूप में आते हैं, और प्रेडिक्शन प्लेटफ़ॉर्म ऑड्स की जगह कॉन्ट्रैक्ट का भाव डॉलर में बताते हैं। डेटा या तो प्लेटफ़ॉर्म की अपनी खुली API से आता है, या ऐसे प्रोवाइडर से जो कई स्पोर्ट्सबुक की लाइनें एक फ़ॉर्मेट में जमा करता है। Polymarket और Kalshi का डेटा Polymarket API और Kalshi API लेख में है।

ऑड्स, प्रोबेबिलिटी और सेंट में भाव

डेसिमल ऑड्स बताते हैं कि हर लगाए डॉलर पर कितना लौटता है, स्टेक समेत: @2.25 पर $100 बन जाते हैं $225। इसका उलटा इम्प्लाइड प्रोबेबिलिटी है: 1 / 2.25 = 0.4444, यानी 44.44%। फ़्रैक्शनल और अमेरिकन ऑड्स को डेसिमल में बदलने के फ़ॉर्मूले बेटिंग ऑड्स की व्याख्या में हैं।

भावडेसिमल ऑड्सप्रोबेबिलिटी
स्पोर्ट्सबुक पर @2.252.2544.44%
स्पोर्ट्सबुक पर @3.603.6027.78%
Polymarket पर 30¢ का YES1 / 0.30 = 3.3330%

YES कॉन्ट्रैक्ट अपना नतीजा होने पर $1 देता है, इसलिए उसका डॉलर भाव मार्केट का प्रोबेबिलिटी अनुमान है। "Bayern की जीत" पर NO कॉन्ट्रैक्ट तब जीतता है जब Dortmund जीते या मैच ड्रॉ हो, जैसे डबल चांस।

एक स्पोर्ट्सबुक पर किसी मार्केट के सभी नतीजों की प्रोबेबिलिटी का जोड़ 1 से ज़्यादा होता है, और यह अधिकता उसका मार्जिन है। उदाहरण: Bayern — Dortmund पर Fonbet की लाइन 2.15 / 3.45 / 3.40 है, तो 0.46512 + 0.28986 + 0.29412 = 1.04910, यानी 4.91% मार्जिन। चरण-दर-चरण गणना बुकमेकर मार्जिन कैसे निकालें में है।

ऑड्स से सरबेट कैसे ढूँढें

सरबेट स्पोर्ट्सबुक के बीच सर्वोत्तम भावों से मिलता है: मार्केट के हर नतीजे के लिए सबसे ऊँचे ऑड्स लें और 1/k जोड़ें। उदाहरण: वही मैच, रेगुलर टाइम पर मैच रिज़ल्ट मार्केट।

नतीजासर्वोत्तम ऑड्सकहाँ1/k
1, Bayern की जीत@2.25Betcity0.44444
X, ड्रॉ@3.60Marathon0.27778
2, Dortmund की जीत@3.80Winline0.26316

L = 0.44444 + 0.27778 + 0.26316 = 0.98538

जोड़ 1 से कम है, इसलिए सरबेट है, और मुनाफ़ा 1 / 0.98538 − 1 = 1.48% है। नीचे के कोड में चारों स्पोर्ट्सबुक की अपनी लाइनों में 3.8% से 5.1% तक का मार्जिन है; सरबेट इस वजह से बनता है कि उन्होंने मैच का भाव अलग-अलग लगाया।

कुल स्टेक 1/k के अनुपात में बँटता है: $1,000 में से होम जीत पर 1,000 × 0.44444 / 0.98538 = $451.04 जाता है, बाकी स्टेक तालिका में हैं।

दांवस्टेकजीतने पर
Betcity · 1 @2.25$451.04$1,014.84
Marathon · X @3.60$281.90$1,014.84
Winline · 2 @3.80$267.06$1,014.83

हर नतीजे पर करीब 1,000 / 0.98538 = $1,014.84 लौटता है; स्टेक के राउंडिंग की वजह से सबसे खराब स्थिति में मुनाफ़ा $14.83 है।

यही तर्क कोड में, इनपुट के रूप में चार स्पोर्ट्सबुक पर एक मार्केट की लाइन:

# Illustrative example: one 1X2 market line at four sportsbooks
line = {
    "Fonbet":   {"1": 2.15, "X": 3.45, "2": 3.40},
    "Betcity":  {"1": 2.25, "X": 3.20, "2": 3.40},
    "Marathon": {"1": 2.05, "X": 3.60, "2": 3.50},
    "Winline":  {"1": 2.10, "X": 3.35, "2": 3.80},
}


def surebet(line, bank):
    outcomes = next(iter(line.values())).keys()
    # best odds for each outcome and the sportsbook offering them
    best = {o: max((odds[o], bk) for bk, odds in line.items())
            for o in outcomes}
    total = sum(1 / k for k, _ in best.values())
    if total >= 1:
        return None  # no surebet
    for o, (k, bk) in best.items():
        print(f"{o}: {bk} @{k} — ${bank / k / total:.2f}")
    return round((1 / total - 1) * 100, 2)


print(surebet(line, 1000), "%")  # 1.48 %

दो नतीजों वाले मार्केट — हैंडीकैप, टोटल, दोनों टीमें गोल करेंगी — में डिक्शनरी में दो कुंजियाँ होती हैं, और फ़ॉर्मूला वही रहता है। स्टेक की राउंडिंग और ऑड्स बदलने के बाद दोबारा गणना पाठ सरबेट कैसे निकालें में है।

मैचिंग: एक मैच, मार्केट, अवधि और लाइन

फ़ॉर्मूला तभी सही है जब हर भाव एक ही मैच के एक ही मार्केट का हो। स्पोर्ट्सबुक टीमों के नाम अलग लिखते हैं, शुरुआत का समय मिनटों से अलग होता है, और मार्केट के अपने नाम होते हैं। मैचिंग की गलती से झूठा सरबेट बनता है: 1/k का जोड़ 1 से कम आता है, पर किसी एक नतीजे पर सारे दांव हार जाते हैं।

क्या जाँचेंकहाँ गड़बड़ होती हैmode=sport में फ़ील्ड
मैच और स्क्वाडBayern बनाम Bayern II, महिला या युवा टीमteams, flags
शुरुआतएक स्पोर्ट्सबुक ने मैच का समय बदला हैstarts_at
मार्केट का प्रकारनतीजा, हैंडीकैप, टोटल, BTTS, सही स्कोरmarket_type
अवधिरेगुलर टाइम या एक्स्ट्रा टाइम समेत मैचperiod
लाइनहैंडीकैप −1.5 और −1.25 अलग दांव हैंline
लेग के नतीजेलेग मिलकर सभी नतीजे कवर करेंlegs[].covers

फ़ुटबॉल में रेगुलर टाइम 90 मिनट और इंजरी टाइम है। बेटिंग प्लेटफ़ॉर्म आम तौर पर फ़ुटबॉल और हॉकी में मैच रिज़ल्ट, हैंडीकैप और टोटल इसी पर सेटल करते हैं, जब तक मार्केट के नाम में न लिखा हो कि एक्स्ट्रा टाइम और शूटआउट शामिल हैं। प्रेडिक्शन प्लेटफ़ॉर्म का विनर मार्केट एक्स्ट्रा टाइम शामिल कर सकता है, और तब रेगुलर टाइम का ड्रॉ पूरी जोड़ी हरा सकता है।

हैंडीकैप सरबेट में उतने ही आकार के उलटे हैंडीकैप से जुड़ता है: होम −1.5 और अवे +1.5। −0.75 जैसे क्वार्टर एशियन हैंडीकैप में स्टेक दो पास की लाइनों में आधा-आधा बँटता है, और होम −0.75 के साथ अवे +0.75 भी हर स्कोर कवर करता है। टोटल एक ही लाइन पर जुड़ते हैं: 2.5 से ज़्यादा के साथ 2.5 से कम।

उलटी जोड़ी, 2.5 से ज़्यादा और 3.5 से कम, एक मिडल है: तीन गोल पर दोनों दांव जीतते हैं। Genesis API में line और period पूरे सरबेट के लिए एक बार तय होते हैं, इसलिए अलग लाइन वाले लेग कभी एक पंक्ति में नहीं आते।

Genesis API से सरबेट: mode=sport

/predictions/arbitrage endpoint mode=sport के साथ ऐसे सरबेट लौटाता है जिनमें यह काम पहले हो चुका है: प्लेटफ़ॉर्म के बीच इवेंट मिलाए जाते हैं, सर्वोत्तम भाव चुने जाते हैं और प्रेडिक्शन प्लेटफ़ॉर्म के लेग फ़ीस के साथ order book से गुज़ारे जाते हैं। प्लेटफ़ॉर्म 13 हैं: Polymarket, Kalshi, Predict.fun और 10 बेटिंग प्लेटफ़ॉर्म — Fonbet, Betcity, Olimpbet, Marathon, 5051X, Melbet, Winline, BC.Game, EGB और Dafa Sports। सिर्फ़ प्री-मैच: मैच शुरू होते ही उसका सरबेट रिस्पॉन्स से हट जाता है।

यह मोड Pro ($100 प्रति माह, हर 10 सेकंड में नया स्नैपशॉट) और Max ($200, हर 5 सेकंड) प्लान का हिस्सा है; Trial और Start पर रिक्वेस्ट 403 plan_restricted लौटाती है। API हर स्पोर्ट्सबुक की पूरी लाइन नहीं लौटाती: रिस्पॉन्स में सिर्फ़ मिले हुए सरबेट होते हैं, हर लेग के प्लेटफ़ॉर्म, नतीजे और भाव के साथ।

curl -G "https://api.genesisarbitrage.com/v1/predictions/arbitrage" \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX" \
  -d mode=sport -d sport=soccer -d min_profit_pct=1.5

उदाहरण: दोबारा गिने भावों के साथ डॉक्यूमेंटेशन की mode=sport पंक्ति:

{
  "id": "s:8812:FT:TOT:2.5:",
  "kind": "sport",
  "match": "sport",
  "title": "Arsenal — Chelsea",
  "category": "sports",
  "sport": "soccer",
  "league": "Premier League",
  "teams": ["Arsenal", "Chelsea"],
  "market_type": "TOT",
  "period": "RT",
  "line": 2.5,
  "score": null,
  "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"
    }
  ]
}

लाइन के पाँच स्तर पंक्ति के फ़ील्ड से इस तरह मिलते हैं:

स्तरफ़ील्डउदाहरण में
इवेंटtitle, sport, league, teams, starts_atArsenal — Chelsea, soccer, Premier League
मार्केटmarket_type, period, line, scoreTOT, FT, 2.5
लेगplatform, side, outcome, coversfonbet, bet, Under 2.5, U
भावodds, price_avg, stake_unit, currency2.12, 0.471698, RUB
नतीजाsize_usd, profit_pct, profit_usd1000, 2.39, null

market_type मार्केट है: WIN — मैच रिज़ल्ट, HCP — हैंडीकैप, TOT — टोटल, BTTS — दोनों टीमें गोल करेंगी, CS — सही स्कोर, जिसमें स्कोर score में होता है। side कॉन्ट्रैक्ट खरीदने के लिए yes या no है और ऑड्स पर दांव के लिए bet। covers उन नतीजों की सूची है जिन्हें लेग कवर करता है: यहाँ O ज़्यादा है और U कम।

stake_unit से स्टेक कैसे बाँटें

stake_unit वह रकम है जो लेग पर लगानी होती है ताकि जीतने पर $1 लौटे। ऑड्स पर दांव के लिए यह 1 / odds है: 1 / 2.12 = 0.471698। YES या NO खरीद के लिए यह फ़ीस समेत order book का औसत भाव है; इस उदाहरण में फ़ीस नहीं है, इसलिए stake_unit price_avg के बराबर है।

यूनिट का जोड़ 0.505 + 0.471698 = 0.976698 है, इसलिए मुनाफ़ा 1 / 0.976698 − 1 = 2.39% है। अपनी रकम S को सरबेट फ़ॉर्मूले से बाँटें: लेग का स्टेक = S × stake_unit / Σ stake_unit। $500 के लिए:

लेगस्टेकजीतने पर
Polymarket · YES "Over 2.5" 50.5¢ पर$258.52511.92 शेयर — $511.92
Fonbet · Under 2.5 @2.12$241.48$511.94

किसी भी नतीजे पर करीब $511.93 लौटता है, सबसे खराब स्थिति में मुनाफ़ा $11.92 है। size_usd वह रकम है जो प्रेडिक्शन प्लेटफ़ॉर्म की order book इन भावों पर सोख लेती हैं। यहाँ यह $1,000 है: 1,000 / 0.505 ≈ 1,980.2 शेयर, इसलिए Fonbet का दांव 1,980.2 × 0.471698 ≈ $934.06 तक जा सकता है, अगर स्पोर्ट्सबुक उसे स्वीकार करे।

profit_usd null है क्योंकि डॉलर में मुनाफ़ा इस पर निर्भर है कि Fonbet कितना स्वीकार करता है, और स्पोर्ट्सबुक अपनी स्टेक सीमा प्रकाशित नहीं करती। इसीलिए min_profit_usd फ़िल्टर स्पोर्ट्सबुक लेग वाला हर सरबेट हटा देता है — उन्हें min_profit_pct से फ़िल्टर करें।

Fonbet का दांव रूबल में है (currency = RUB)। उदाहरण के लिए 80 ₽ प्रति $1 की दर पर यह 241.48 × 80 = 19,318.40 ₽ है, और "2.5 से कम" 19,318.40 × 2.12 = 40,955.01 ₽ लौटाता है। कन्वर्ज़न पर विनिमय दर का अंतर profit_pct में शामिल नहीं है।

Python: min_profit_pct के साथ फ़ुटबॉल सरबेट

स्क्रिप्ट 1.5% या ज़्यादा मुनाफ़े वाले फ़ुटबॉल सरबेट माँगती है, हर एक को किक-ऑफ़ तक के समय के साथ छापती है और BANK की रकम stake_unit के हिसाब से लेग में बाँटती है। कुंजी GENESIS_API_KEY एनवायरनमेंट वैरिएबल से आती है; कुंजी कैसे लें, यह क्विकस्टार्ट में है।

import os
import time

import requests

API = "https://api.genesisarbitrage.com/v1"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}
PARAMS = {"mode": "sport", "sport": "soccer", "min_profit_pct": 1.5}
BANK = 500  # total stake for the whole surebet, $


def fetch():
    while True:
        r = requests.get(f"{API}/predictions/arbitrage",
                         headers=HEADERS, params=PARAMS, timeout=10)
        if r.status_code in (429, 503):
            time.sleep(int(r.headers.get("Retry-After", "5")))
            continue
        if r.status_code == 403:
            raise SystemExit("mode=sport के लिए Pro या Max प्लान चाहिए")
        r.raise_for_status()
        return r.json()["data"]


def unit(leg):  # $1 of winnings: stake_unit, else 1/odds or price
    if leg.get("stake_unit"):
        return leg["stake_unit"]
    return 1 / leg["odds"] if leg.get("odds") else leg["price_avg"]


for row in fetch():
    mkt = [row["market_type"], row["line"], row["period"]]
    mkt = " ".join(str(v) for v in mkt if v is not None)
    hours = (row["starts_at"] - time.time()) / 3600
    print(f"{row['profit_pct']}% · {row['title']} · {mkt} · "
          f"{hours:.1f} घंटे में शुरू")
    total = sum(unit(leg) for leg in row["legs"])
    for leg in row["legs"]:
        price = leg.get("odds") or leg.get("price_avg")
        print(f"   {leg['platform']}: {leg['outcome']} at {price} — "
              f"${BANK * unit(leg) / total:.2f} ({leg['currency']})")

हर लेग की रकम प्लेटफ़ॉर्म की मुद्रा के साथ डॉलर में छपती है: रूबल के दांव को अपनी दर से बदलें। अगर किसी लेग में stake_unit नहीं है, तो unit फ़ीस के बिना 1 / odds या price_avg पर आ जाता है, इसलिए मुनाफ़ा असल से थोड़ा ज़्यादा दिखता है।

नए सरबेट पर नज़र रखने के लिए हर meta.freshness_sec पर रिक्वेस्ट दोहराएँ और id की तुलना करें: हर सरबेट अपना id बनाए रखता है। फ़िल्टर किया रिस्पॉन्स ETag के बिना आता है, इसलिए कोटा अंतराल से बचता है: Pro पर हर 10 सेकंड यानी 86,400 / 10 = 8,640 कॉल रोज़ और 8,640 × 30 = 259,200 कॉल 30 दिन में, 5M कोटा के मुकाबले, Genesis API की सीमाएँ देखें। league, platform (जैसे fonbet) और max_days फ़िल्टर प्रेडिक्शन मार्केट endpoint गाइड में बताए गए हैं।

जिन जोखिमों को API जाँच नहीं सकती

API सरबेट का भाव एक स्नैपशॉट से लगाती है, जबकि दांव आप खुद दो या तीन प्लेटफ़ॉर्म पर लगाते हैं, और हर एक गणित बिगाड़ सकता है।

बेटिंग का नियमन हर देश में अलग है: अपने स्थानीय कानून और हर प्लेटफ़ॉर्म के नियम जाँचें। काम का क्रम और सभी जोखिम पाठ सरबेट के जोखिम और काम के नियम में हैं, और खोज कैसे काम करती है यह सरबेट स्कैनर में समझाया गया है।

कॉलम, फ़िल्टर और लेबल Sport मोड गाइड में बताए गए हैं।

सवाल और जवाब

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

यह प्रोवाइडर पर निर्भर है: रिक्वेस्ट का कोटा और स्पोर्ट्सबुक व मार्केट की सूची अलग होती है, और मुफ़्त एक्सेस, जहाँ है, मात्रा में सीमित है। Polymarket और Kalshi मार्केट डेटा अपनी आधिकारिक API से बिना कुंजी देते हैं (Polymarket, Kalshi), पर वे YES और NO कॉन्ट्रैक्ट के भाव हैं, स्पोर्ट्सबुक के ऑड्स नहीं। Genesis API में मुफ़्त प्लान नहीं है: mode=sport Pro ($100 प्रति माह) और Max ($200) में है; प्लान की तुलना Genesis API की कीमतें पर करें।

क्या API में लाइव ऑड्स हैं?

Genesis API में नहीं: sport मोड सिर्फ़ प्री-मैच सरबेट खोजता है, और मैच शुरू होते ही सरबेट रिस्पॉन्स से हट जाता है। लाइव आर्ब ज़्यादा क्यों टूटते हैं, यह प्री-मैच बनाम इन-प्ले आर्बिट्राज में है।

सरबेट में profit_usd null क्यों है?

कम से कम एक लेग स्पोर्ट्सबुक का दांव है, और स्पोर्ट्सबुक आपके अकाउंट की स्टेक सीमा प्रकाशित नहीं करती। profit_pct प्रतिशत पता है; हर लेग की रकम stake_unit से निकालें।

क्या Genesis API से दांव लगाए जा सकते हैं?

नहीं। Genesis API सिर्फ़ डेटा पढ़ती है: दांव और खरीद आप खुद प्लेटफ़ॉर्म पर लगाते हैं, legs[].url के लिंक से।