आर्बिट्राज बेटिंग के लिए 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_usdnull होता है, क्योंकि स्पोर्ट्सबुक की स्टेक सीमा पता नहीं होती।
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.25 | 2.25 | 44.44% |
| स्पोर्ट्सबुक पर @3.60 | 3.60 | 27.78% |
| Polymarket पर 30¢ का YES | 1 / 0.30 = 3.33 | 30% |
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.25 | Betcity | 0.44444 |
| X, ड्रॉ | @3.60 | Marathon | 0.27778 |
| 2, Dortmund की जीत | @3.80 | Winline | 0.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_at | Arsenal — Chelsea, soccer, Premier League |
| मार्केट | market_type, period, line, score | TOT, FT, 2.5 |
| लेग | platform, side, outcome, covers | fonbet, bet, Under 2.5, U |
| भाव | odds, price_avg, stake_unit, currency | 2.12, 0.471698, RUB |
| नतीजा | size_usd, profit_pct, profit_usd | 1000, 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.52 | 511.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 सरबेट का भाव एक स्नैपशॉट से लगाती है, जबकि दांव आप खुद दो या तीन प्लेटफ़ॉर्म पर लगाते हैं, और हर एक गणित बिगाड़ सकता है।
- ऑड्स बदलते हैं। स्नैपशॉट और आपके दांव के बीच सेकंड या मिनट बीतते हैं: स्पोर्ट्सबुक ऑड्स घटा देती है, या book के सस्ते ऑर्डर भर जाते हैं।
- सीमाएँ और स्टेक लिमिटिंग। स्पोर्ट्सबुक माँगी रकम से कम स्वीकार कर सकती है या अकाउंट लिमिट कर सकती है; कारण स्पोर्ट्सबुक आर्बर्स को लिमिट क्यों करती हैं में हैं। पहले ऑड्स पर दांव लगाएँ और फिर स्वीकार हुई रकम के बराबर YES या NO खरीदें।
- वॉइड। अगर मैच रद्द या स्थगित हो, तो स्पोर्ट्सबुक आम तौर पर दांव 1 के ऑड्स पर लौटा देती है, जबकि YES/NO मार्केट अपने नियमों से सेटल होता है, और सरबेट घाटे में खत्म हो सकता है।
- मुद्रा। रूबल और डॉलर का कन्वर्ज़न पंक्ति के मुनाफ़े में शामिल नहीं है।
- भाव की भारी गलती। दूसरी स्पोर्ट्सबुक से बहुत ऊँचे ऑड्स गलती हो सकते हैं, और स्पोर्ट्सबुक दांव दोबारा सेटल कर सकती है।
बेटिंग का नियमन हर देश में अलग है: अपने स्थानीय कानून और हर प्लेटफ़ॉर्म के नियम जाँचें। काम का क्रम और सभी जोखिम पाठ सरबेट के जोखिम और काम के नियम में हैं, और खोज कैसे काम करती है यह सरबेट स्कैनर में समझाया गया है।
कॉलम, फ़िल्टर और लेबल 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 के लिंक से।