API احتمالات المراهنات الرياضية للأربيتراج: الأحداث والاحتمالات وsurebet عبر API
باختصار
- يُرجع API احتمالات المراهنات الرياضية الأحداث والأسواق واحتمالات كل شركة مراهنات مع وقت آخر تحديث. الاحتمالية الضمنية للاحتمالات العشرية هي 1/k، وسعر عقد YES في سوق التنبؤ هو الاحتمالية نفسها بالدولار.
- تظهر surebet عندما يكون مجموع 1/k لأفضل احتمالات جميع نتائج السوق أقل من 1، وتتناسب كل حصة رهان مع 1/k. تقع معظم الأخطاء في المطابقة: يجب أن تكون المباراة والسوق والفترة والخط هي نفسها في كل منصة.
- في
mode=sportضمن خطتي Pro وMax يُرجع Genesis API فرص surebet قبل المباراة عبر 13 منصة معstake_unitلكل ساق. قيمةprofit_usdفيها null لأن حد الرهان لدى شركة المراهنات غير معروف.
يمنح API احتمالات المراهنات الرياضية، ويسمى أيضاً API المراهنات الرياضية، البرنامجَ خط الرهان: الأحداث والأسواق واحتمالات كل شركة مراهنات مع وقت آخر تحديث لكل سعر. من هذه البيانات يقارن البرنامج الأسعار بين المنصات ويجد surebet — رهانات على كل نتائج المباراة تنتهي بربح أياً كانت النتيجة، بشرط أن تُقبل كل الرهانات وتُسوّى بالقواعد نفسها. هذا هو أربيتراج المراهنات، ويقدّم Genesis API فرص surebet جاهزة عبر 13 منصة من خلال نقطة النهاية /predictions/arbitrage مع mode=sport.
ماذا يُرجع 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
تُرجع نقطة النهاية /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 ₽ للدولار يكون ذلك 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 موصوفة في دليل نقاط نهاية أسواق التنبؤ.
مخاطر لا يستطيع 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 يساوي null في surebet؟
ساق واحدة على الأقل رهان لدى شركة مراهنات، ولا تنشر شركة المراهنات حد الرهان لحسابك. النسبة profit_pct معروفة؛ واحسب مبلغ كل ساق من stake_unit.
هل يمكن وضع الرهانات عبر Genesis API؟
لا. يقرأ Genesis API البيانات فقط: تضع الرهانات والمشتريات بنفسك على المنصات، عبر الروابط في legs[].url.