Genesis Arbitrage

Genesis Arbitrage · · 14 دقیقه مطالعه

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.2544.44%
@3.60 نزد بوکمیکر3.6027.78%
YES با 30¢ در Polymarket1 / 0.30 = 3.3330%

قرارداد 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.25Betcity0.44444
X، مساوی@3.60Marathon0.27778
2، برد Dortmund@3.80Winline0.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.25451.04$1,014.84$
Marathon · X @3.60281.90$1,014.84$
Winline · 2 @3.80267.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_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 میانگین قیمت دفتر سفارش با احتساب کارمزد است؛ در نمونهٔ توضیحی کارمزدی نیست، پس 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.12241.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 را از روی یک اسنپ‌شات قیمت‌گذاری می‌کند، در حالی که شرط‌ها را خودتان در دو یا سه پلتفرم می‌بندید و هر کدام می‌تواند حساب را بر هم بزند.

مقررات شرط‌بندی در کشورهای مختلف متفاوت است: قوانین محلی و قواعد هر پلتفرم را بررسی کنید. ترتیب کار و همهٔ ریسک‌ها در درس ریسک‌های 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.