API ضرایب ورزشی برای آربیتراژ شرطبندی: رویدادها، ضرایب و surebet از طریق API
به طور خلاصه
- API ضرایب ورزشی رویدادها، بازارها و ضرایب هر بوکمیکر را همراه با زمان آخرین بهروزرسانی برمیگرداند. احتمال ضمنی ضریب اعشاری 1/k است و قیمت قرارداد YES در بازار پیشبینی همان احتمال به دلار است.
- surebet وقتی وجود دارد که مجموع 1/k بهترین ضرایب همهٔ نتایج یک بازار کمتر از 1 شود و مبلغ هر شرط متناسب با 1/k باشد. بیشتر خطاها در تطبیق رخ میدهد: مسابقه، بازار، دوره و خط در همهٔ پلتفرمها باید یکی باشد.
- در
mode=sportدر پلنهای Pro و Max، Genesis API برای 13 پلتفرم surebetهای پیش از بازی را باstake_unitبرای هر پایه برمیگرداند. مقدارprofit_usdدر آنها null است، چون سقف شرط بوکمیکر معلوم نیست.
API ضرایب ورزشی که API شرطبندی ورزشی هم نامیده میشود، خط شرطبندی را در اختیار برنامه میگذارد: رویدادها، بازارها و ضرایب هر بوکمیکر، با زمان آخرین بهروزرسانی هر قیمت. برنامه با این دادهها قیمتها را بین پلتفرمها مقایسه میکند و surebet پیدا میکند — شرطهایی روی همهٔ نتایج یک مسابقه که با هر نتیجهای به سود ختم میشوند، به شرط آنکه همهٔ شرطها پذیرفته و با قواعد یکسان تسویه شوند. این آربیتراژ شرطبندی است و Genesis API از طریق endpoint /predictions/arbitrage با mode=sport surebetهای آماده را در 13 پلتفرم ارائه میدهد.
API ضرایب ورزشی چه چیزی برمیگرداند
ارائهدهندگان نام فیلدها را متفاوت میگذارند، اما API ضرایب خط را در پنج سطح توصیف میکند. بدون دوره و خط نمیتوان دو ضریب را مقایسه کرد و بدون زمان نمیدانید قیمت هنوز معتبر است یا نه. ستون سمت چپ نمونهٔ توضیحی است.
| سطح | شامل چه چیزی است | نمونه |
|---|---|---|
| رویداد | ورزش، رقابت، تیمها، شروع | فوتبال، بوندسلیگا، Bayern — Dortmund |
| بازار | نوع شرط، دوره، خط | مجموع 2.5، وقت قانونی |
| نتیجه | شرط روی چه چیزی است | بیش از 2.5 |
| قیمت | ضرایب هر بوکمیکر | Fonbet @1.95، Winline @2.02 |
| زمان | قیمت کی بهروز شده | 12 ثانیه پیش |
ضرایب بهصورت اعشاری، کسری یا آمریکایی میرسند و پلتفرمهای پیشبینی بهجای ضریب، قیمت قرارداد را به دلار اعلام میکنند. داده یا از API باز خود پلتفرم میآید یا از ارائهدهندهای که خطوط بوکمیکرهای زیادی را در یک قالب جمع میکند. دادههای Polymarket و Kalshi در مقالهٔ Polymarket API و Kalshi API آمده است.
ضریب، احتمال و قیمت به سنت
ضریب اعشاری نشان میدهد بهازای هر دلار شرط چقدر برمیگردد، با احتساب خود مبلغ شرط: 100$ با @2.25 میشود 225$. معکوس آن احتمال ضمنی است: 1 / 2.25 = 0.4444 یعنی 44.44%. ضرایب کسری و آمریکایی با فرمولهای توضیح ضرایب شرطبندی به اعشاری تبدیل میشوند.
| قیمت | ضریب اعشاری | احتمال |
|---|---|---|
| @2.25 نزد بوکمیکر | 2.25 | 44.44% |
| @3.60 نزد بوکمیکر | 3.60 | 27.78% |
| YES با 30¢ در Polymarket | 1 / 0.30 = 3.33 | 30% |
قرارداد YES اگر نتیجهاش رخ دهد 1$ میپردازد، پس قیمت دلاری آن برآورد بازار از احتمال است. قرارداد NO روی «برد Bayern» اگر Dortmund ببرد یا مسابقه مساوی شود برنده است، مثل شانس دوگانه.
نزد یک بوکمیکر مجموع احتمال همهٔ نتایج یک بازار از 1 بیشتر میشود و مازاد آن حاشیه اوست. نمونهٔ توضیحی: خط Fonbet روی Bayern — Dortmund یعنی 2.15 / 3.45 / 3.40 میشود 0.46512 + 0.28986 + 0.29412 = 1.04910 یعنی حاشیهٔ 4.91%. محاسبهٔ گامبهگام در چطور حاشیهٔ بوکمیکر را حساب کنیم است.
چطور از ضرایب surebet پیدا کنیم
surebet از بهترین قیمتها در میان بوکمیکرها پیدا میشود: برای هر نتیجهٔ بازار بالاترین ضریب را بردارید و 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 است، پس surebet وجود دارد و سود آن 1 / 0.98538 − 1 = 1.48% است. خطوط خود چهار بوکمیکر در کد زیر حاشیهای از 3.8% تا 5.1% دارند؛ surebet از تفاوت قیمتگذاری آنها برای مسابقه ناشی میشود.
کل مبلغ شرط متناسب با 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 %
بازار دونتیجهای — هندیکپ، مجموع، هر دو تیم گل بزنند — در دیکشنری دو کلید دارد و فرمول همان میماند. گرد کردن مبالغ و بازمحاسبه پس از حرکت ضرایب در درس چطور surebet را حساب کنیم آمده است.
تطبیق: یک مسابقه، بازار، دوره و خط
فرمول فقط وقتی درست است که همهٔ قیمتها به یک بازار از یک مسابقه تعلق داشته باشند. بوکمیکرها نام تیمها را متفاوت مینویسند، زمان شروع چند دقیقه فرق دارد و بازارها نامهای خودشان را دارند. خطای تطبیق surebet کاذب میسازد: مجموع 1/k کمتر از 1 میشود، اما روی یکی از نتایج همهٔ شرطها میبازند.
| چه چیزی را بررسی کنیم | کجا خطا رخ میدهد | فیلد در mode=sport |
|---|---|---|
| مسابقه و ترکیب | Bayern در برابر Bayern II، تیم بانوان یا جوانان | teams، flags |
| شروع | یک بوکمیکر مسابقه را جابهجا کرده است | starts_at |
| نوع بازار | نتیجه، هندیکپ، مجموع، BTTS، نتیجهٔ دقیق | market_type |
| دوره | وقت قانونی یا مسابقه با وقت اضافه | period |
| خط | هندیکپ −1.5 و −1.25 دو شرط متفاوتاند | line |
| نتایج پایهها | پایهها با هم باید همهٔ نتایج را پوشش دهند | legs[].covers |
وقت قانونی در فوتبال 90 دقیقه بهعلاوهٔ وقت تلفشده است. پلتفرمهای شرطبندی معمولاً نتیجهٔ مسابقه، هندیکپ و مجموع را در فوتبال و هاکی روی آن تسویه میکنند، مگر آنکه نام بازار بگوید وقت اضافه و ضربات پنالتی هم حساب میشود. بازار برنده در پلتفرم پیشبینی ممکن است وقت اضافه را شامل شود و آنوقت مساوی در وقت قانونی میتواند کل جفت را ببازد.
هندیکپ در surebet با هندیکپ مقابل هماندازه جفت میشود: میزبان −1.5 و میهمان +1.5. در هندیکپ آسیایی چهارتایی مثل −0.75 مبلغ بین دو خط مجاور نصفنصف میشود و میزبان −0.75 با میهمان +0.75 هم همهٔ نتایج را میپوشاند. مجموعها روی یک خط جفت میشوند: بیش از 2.5 با کمتر از 2.5.
جفت معکوس، بیش از 2.5 و کمتر از 3.5، یک شرط میانی است: با سه گل هر دو شرط میبرند. در Genesis API مقدار line و period برای کل surebet یک بار تعیین میشود، پس پایههایی با خطوط متفاوت هرگز در یک ردیف نمیآیند.
surebet با Genesis API: mode=sport
endpoint /predictions/arbitrage با mode=sport surebetهایی برمیگرداند که این کار در آنها انجام شده است: رویدادها بین پلتفرمها تطبیق داده میشوند، بهترین قیمتها انتخاب میشوند و پایههای پلتفرم پیشبینی با کارمزد از دفتر سفارش عبور داده میشوند. پلتفرمها 13 تا هستند: Polymarket، Kalshi، Predict.fun و 10 پلتفرم شرطبندی — Fonbet، Betcity، Olimpbet، Marathon، 5051X، Melbet، Winline، BC.Game، EGB و Dafa Sports. فقط پیش از بازی: با شروع مسابقه، surebet آن از پاسخ بیرون میرود.
این حالت جزو پلنهای Pro (100$ در ماه، اسنپشات جدید هر 10 ثانیه) و Max (200$، هر 5 ثانیه) است؛ در Trial و Start درخواست 403 plan_restricted برمیگرداند. API خط کامل هر بوکمیکر را برنمیگرداند: پاسخ فقط surebetهای پیداشده را دارد، با پلتفرم، نتیجه و قیمت هر پایه.
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 میانگین قیمت دفتر سفارش با احتساب کارمزد است؛ در نمونهٔ توضیحی کارمزدی نیست، پس stake_unit با price_avg برابر است.
واحدها جمعاً 0.505 + 0.471698 = 0.976698 میشوند، پس سود 1 / 0.976698 − 1 = 2.39% است. مبلغ خودتان S را با فرمول surebet تقسیم کنید: مبلغ پایه = 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 مقداری است که دفتر سفارش پلتفرمهای پیشبینی با این قیمتها جذب میکند. اینجا 1,000$ است: 1,000 / 0.505 ≈ 1,980.2 سهم، پس شرط Fonbet میتواند تا 1,980.2 × 0.471698 ≈ 934.06$ برود، اگر بوکمیکر بپذیرد.
profit_usd برابر null است، چون سود دلاری به مقداری بستگی دارد که Fonbet میپذیرد و بوکمیکر سقف شرط را منتشر نمیکند. به همین دلیل فیلتر min_profit_usd هر surebet دارای پایهٔ بوکمیکر را حذف میکند — آنها را با 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: surebetهای فوتبال با min_profit_pct
اسکریپت surebetهای فوتبال با سود 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 بدون کارمزد برمیگردد و سود کمی بیشتر از واقعیت درمیآید.
برای پیگیری surebetهای جدید درخواست را هر meta.freshness_sec تکرار کنید و مقادیر id را مقایسه کنید: هر surebet شناسهٔ خود را حفظ میکند. پاسخ فیلترشده بدون ETag میآید، پس با فاصلهٔ زمانی در سهمیه صرفهجویی میکنید: هر 10 ثانیه در Pro یعنی 86,400 / 10 = 8,640 فراخوانی در روز و 8,640 × 30 = 259,200 در 30 روز در برابر سهمیهٔ 5M، محدودیتهای Genesis API را ببینید. فیلترهای league، platform (مثلاً fonbet) و max_days در راهنمای endpointهای بازارهای پیشبینی توضیح داده شدهاند.
ریسکهایی که API نمیتواند بررسی کند
API surebet را از روی یک اسنپشات قیمتگذاری میکند، در حالی که شرطها را خودتان در دو یا سه پلتفرم میبندید و هر کدام میتواند حساب را بر هم بزند.
- ضرایب حرکت میکنند. بین اسنپشات و شرط شما ثانیهها یا دقیقهها میگذرد: بوکمیکر ضریب را کم میکند یا سفارشهای ارزان دفتر پر میشوند.
- سقفها و محدودسازی حساب. بوکمیکر ممکن است کمتر از مبلغ درخواستی بپذیرد یا حساب را محدود کند؛ دلایل در چرا بوکمیکرها آربیتراژکارها را محدود میکنند آمده است. ابتدا شرط با ضریب را ببندید و بعد YES یا NO را به اندازهٔ مبلغ پذیرفتهشده بخرید.
- ابطال (Void). اگر مسابقه لغو یا به تعویق بیفتد، بوکمیکر معمولاً شرط را با ضریب 1 برمیگرداند، در حالی که بازار YES/NO با قواعد خودش تسویه میشود و surebet ممکن است با ضرر تمام شود.
- ارز. تبدیل روبل و دلار در سود ردیف لحاظ نشده است.
- خطای فاحش قیمت. ضریبی بسیار بالاتر از دیگر بوکمیکرها میتواند اشتباه باشد و بوکمیکر ممکن است شرط را دوباره تسویه کند.
مقررات شرطبندی در کشورهای مختلف متفاوت است: قوانین محلی و قواعد هر پلتفرم را بررسی کنید. ترتیب کار و همهٔ ریسکها در درس ریسکهای surebet و قواعد کار جمع شدهاند و نحوهٔ کار جستوجو در اسکنر surebet توضیح داده شده است.
ستونها، فیلترها و برچسبها در راهنمای حالت Sport توضیح داده شدهاند.
پرسش و پاسخ
آیا API ضرایب ورزشی رایگان وجود دارد؟
بستگی به ارائهدهنده دارد: سهمیهٔ درخواستها و فهرست بوکمیکرها و بازارها فرق میکند و دسترسی رایگان، جایی که هست، از نظر حجم محدود است. Polymarket و Kalshi دادههای بازار را از طریق API رسمی خود بدون کلید ارائه میدهند (Polymarket، Kalshi)، اما اینها قیمت قراردادهای YES و NOاند و ضریب بوکمیکر ندارند. Genesis API پلن رایگان ندارد: mode=sport در Pro (100$ در ماه) و Max (200$) است؛ پلنها را در تعرفهٔ Genesis API مقایسه کنید.
آیا API ضرایب زنده دارد؟
در Genesis API نه: حالت sport فقط surebetهای پیش از بازی را میجوید و surebet با شروع مسابقه از پاسخ بیرون میرود. اینکه چرا آربیتراژ زنده بیشتر میشکند در آربیتراژ پیش از بازی و حین بازی آمده است.
چرا profit_usd در surebet برابر null است؟
دستکم یک پایه شرط بوکمیکر است و بوکمیکر سقف شرط حساب شما را منتشر نمیکند. درصد profit_pct معلوم است؛ مبلغ هر پایه را از stake_unit حساب کنید.
آیا میتوان با Genesis API شرط بست؟
نه. Genesis API فقط داده میخواند: شرطها و خریدها را خودتان در پلتفرمها میبندید، با لینکهای legs[].url.