أسواق التنبؤ وأربيتراج الرهان في Genesis API: نقاط النهاية والفلاتر والحقول
باختصار
- ست نقاط نهاية: مراجحة التنبؤات وحالة المنصات متاحة من خطة Start، والتحليلات والأموال الذكية والصفقات الكبيرة وترتيب المتداولين في خطتي Pro وMax.
- تأتي حزم المراجحة محسوبة مسبقاً عبر دفاتر الأوامر مع الرسوم: حجم الصفقة والربح بالدولار وبالنسبة المئوية وAPR والأيام حتى التسوية ورموز المخاطر.
- يعيد وضع sport فرص أربيتراج الرهان عبر 13 منصة، قبل المباراة فقط. وإذا كانت إحدى الساقين رهاناً بأودز فإن profit_usd يساوي null لأن حد مبلغ هذا الرهان غير معروف.
يقدّم Genesis API بيانات أسواق التنبؤ عبر ست نقاط نهاية GET: حزم المراجحة بين Polymarket وKalshi وLimitless وPredict.fun وOpinion، وفرص أربيتراج الرهان عبر 13 منصة، وحالة المنصات، والتحليلات، والأموال الذكية، والصفقات الكبيرة، وترتيب المتداولين. هذه هي البيانات نفسها خلف صفحات مراجحة التنبؤات والتحليلات والأموال الذكية بصيغة JSON. ابنِ عليها بوتاً أو لوحة متابعة أو تنبيهات؛ أما الصفقات والرهانات فتنفّذها أنت على المنصات.
نقاط النهاية والخطط
| نقطة النهاية | ما تعيده | خطط API |
|---|---|---|
/predictions/arbitrage | حزم المراجحة وفرص أربيتراج الرهان | Start وPro وMax؛ وضعا llm وsport — Pro وMax |
/predictions/platforms | حالة المنصات | Start وPro وMax |
/predictions/analytics | مؤشرات KPI وتحركات الأسعار وتدفقات الأموال | Pro وMax |
/predictions/smart-money | الصفقات الكبيرة والحيتان وأنماط المطّلعين | Pro وMax |
/predictions/trades | شريط صفقات Polymarket | Pro وMax |
/predictions/traders | أفضل 300 متداول على Polymarket حسب PnL | Pro وMax |
في خطة Trial تعيد النقاط الست كلها 403 plan_restricted؛ وفي Start يحدث الأمر نفسه للطلبات بـ mode=llm وmode=sport. صيغة الاستجابة موضّحة في دليل الاستجابات والأخطاء، والحصة في دليل الحدود.
مراجحة التنبؤات: الأوضاع
يحدّد المعامل mode أي الحزم تعيدها /predictions/arbitrage.
mode | ما تحصل عليه | kind | الخطط |
|---|---|---|---|
exact | الحدث نفسه على منصتين، وهو الافتراضي | cross | Start وPro وMax |
dutch | مجموعة نتائج لحدث واحد على منصة واحدة | dutch | Start وPro وMax |
llm | أزواج أحداث تحقّق منها الذكاء الاصطناعي | cross | Pro وMax |
sport | فرص أربيتراج الرهان على المباريات | sport | Pro وMax |
الربح محسوب مسبقاً عبر دفاتر أوامر المنصات مع الرسوم. طلب حزم exact بربح 1% على الأقل وتُسوّى خلال 30 يوماً:
curl -G "https://api.genesisarbitrage.com/v1/predictions/arbitrage" \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX" \
-d mode=exact -d min_profit_pct=1 -d max_days=30
الفلاتر
| المعامل | النوع | وظيفته |
|---|---|---|
mode | string | exact (الافتراضي) أو dutch أو llm أو sport |
category | string | الفئة، كما في حقل category |
platform | string | ساق واحدة على الأقل على هذه المنصة؛ وعند عدة منصات تُفصل بفواصل |
min_profit_pct | number | الحد الأدنى للربح، % |
min_profit_usd | number | الحد الأدنى للربح، $؛ تُتخطى الصفوف التي فيها profit_usd = null |
min_apr | number | الحد الأدنى لـ APR، % |
max_days | number | أقصى عدد أيام حتى التسوية |
sport, league | string | الرياضة والدوري، لوضع mode=sport |
الفلاتر اختيارية ويمكن الجمع بينها. اكتب المنصة كما في legs[].platform: polymarket أو kalshi أو fonbet. القيمة غير المعروفة لـ mode تعيد 400 bad_request.
الحزمة وساقاها
مثال توضيحي: صف من mode=exact من التوثيق، مختصر.
{
"id": "x:exact:kalshi:KXFRENCHPRES-27-JCAS~polymarket:0x8c1f…",
"kind": "cross",
"match": "exact",
"title": "Will Jean Castex win the 2027 French presidential…",
"category": "Elections",
"ends_at": 1843308000,
"days_left": 562.87,
"size_usd": 107175.08,
"fees_usd": 28.08,
"profit_usd": 153.69,
"profit_pct": 0.14,
"apr_pct": 0.1,
"shares": 107356.85,
"risks": ["rules_differ", "end_mismatch"],
"legs": [
{
"platform": "polymarket",
"side": "yes",
"outcome": "Jean Castex",
"price_avg": 0.0013,
"cost_usd": 140.3,
"fee_usd": 5.6,
"url": "https://polymarket.com/event/next-french-presidential-…"
},
{
"platform": "kalshi",
"side": "no",
"outcome": "No",
"price_avg": 0.997,
"cost_usd": 107034.78,
"fee_usd": 22.48,
"url": "https://kalshi.com/events/KXFRENCHPRES-27"
}
]
}
| الحقل | المعنى |
|---|---|
id, first_seen, updated_at | معرّف ثابت، ووقت ظهور الحزمة ووقت تحديثها |
kind, match | cross أو dutch أو sport؛ وmatch هو exact أو llm أو sport |
title, category | الحدث أو السوق وفئته |
ends_at, days_left, starts_at | وقت التسوية، والأيام حتى التسوية، وبداية المباراة |
size_usd, fees_usd, shares | حجم الصفقة والرسوم بالدولار، وعدد الأسهم |
profit_usd, profit_pct, apr_pct | الربح بالدولار وبالنسبة المئوية، وAPR؛ وتكون apr_pct تساوي null لأقل من يوم |
edge_cents, risks | فارق السعر بالسنت للسهم الواحد، ورموز المخاطر |
legs[].platform, market, outcome | منصة الساق وسوقها ونتيجتها |
legs[].side | yes أو no — ما يُشترى؛ وbet — رهان بأودز |
legs[].price_best, price_avg, price_worst | أفضل سعر ومتوسطه وأسوؤه عند المرور على الدفتر |
legs[].shares, cost_usd, fee_usd, url | أسهم الساق وتكلفتها ورسومها ورابط السوق |
سعر الساق جزء من الدولار: السهم يعيد 1$ إذا فازت نتيجته، فـ 0.997 تعني 99.7 سنتاً. إذا سوّت المنصتان بالطريقة نفسها فإحدى الساقين تربح مهما حدث، وshares هو المبلغ الذي تستلمه. تعني rules_differ أن قواعد التسوية في المنصتين قد تختلف؛ وتعني end_mismatch أن تواريخ التسوية مختلفة.
في المثال: 107,356.85 − 107,175.08 − 28.08 = 153.69$ ربحاً، أي 153.69 / 107,203.16 = 0.14%. المال محجوز 562.87 يوماً حتى التسوية، فيصبح المعدل السنوي 0.14 × 365 / 562.87 ≈ 0.1%. يستبعد الفلتر max_days مثل هذه الحزم.
وضع sport: فرص أربيتراج الرهان
صف sport هو سوق واحد من مباراة واحدة: ساقان أو ثلاث على منصات مختلفة تغطي معاً كل نتائجه. المنصات 13: Polymarket وKalshi وPredict.fun و10 منصات رهان — Fonbet وBetcity وOlimpbet وMarathon و5051X وMelbet وWinline وBC.Game وEGB وDafa Sports. قبل المباراة فقط: ما إن تبدأ المباراة تخرج الفرصة من القائمة.
مثال توضيحي: صف من mode=sport من التوثيق بأسعار أعيد حسابها.
{
"id": "s:8812:RT:TOT:2.5:",
"kind": "sport",
"title": "Arsenal — Chelsea",
"sport": "soccer",
"league": "Premier League",
"teams": ["Arsenal", "Chelsea"],
"market_type": "TOT",
"period": "RT",
"line": 2.5,
"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"
}
]
}
| الحقل | المعنى |
|---|---|
sport, league, teams, flags | الرياضة والدوري والفريقان ووسوم المباراة |
market_type | WIN — النتيجة، وHCP — الإعاقة، وTOT — المجموع، وBTTS — تسجيل الفريقين، وCS — النتيجة الدقيقة |
period, line, score | فترة التسوية، وخط الإعاقة أو المجموع، والنتيجة لـ CS |
legs[].covers | النتائج التي تغطيها الساق: O — أكثر، وU — أقل |
legs[].odds | الأودز العشرية؛ وتكون null عند شراء YES أو NO |
legs[].stake_unit | حصة الرهان: كم تضع على الساق لتحصل على 1$ إذا فازت، شاملاً الرسوم |
legs[].currency | عملة المنصة |
في الرهان بأودز: stake_unit = 1 / odds، أي 1 / 2.12 = 0.471698. مجموع وحدات الرهان عبر الساقين 0.505 + 0.471698 = 0.976698، وهو أقل من 1، ومن هنا الربح 1 / 0.976698 − 1 = 2.39%. لتوزيع مبلغك الخاص استخدم leg stake = amount × stake_unit / Σ stake_unit.
size_usd هو مبلغ المشتريات على منصات التنبؤ الذي تستطيع دفاتر أوامرها استيعابه. 1,000$ بسعر 0.505 تشتري 1,000 / 0.505 ≈ 1,980.2 سهم YES لـ «Over 2.5». ولكي يعيد «Under 2.5» المبلغ نفسه يكون رهان Fonbet 1,980.2 × 0.471698 ≈ 934.06$.
تقبل Fonbet الرهان بالروبل (currency = RUB): حوّل المبلغ بسعر صرفك أنت، فالتحويل ليس ضمن profit_pct. وprofit_usd تساوي null هنا لأن منصة الرهان لا تنشر حد مبلغ الرهان.
حالة المنصات
تعرض /predictions/platforms مدى حداثة بيانات المراجحة. لا تأخذ معاملات؛ وتحتوي data على قائمتين:
{
"platforms": [
{
"platform": "kalshi",
"mode": "rest",
"quotes_at": 1794675858,
"full_scan_at": 1794675012,
"markets": 26187,
"hot_markets": 188
}
],
"bookmakers": [
{
"bookmaker": "fonbet",
"title": "Fonbet",
"ok": true,
"events": 1840,
"matched_events": 212,
"updated_at": 1794675855,
"currency": "RUB"
}
]
}
-
platforms[].mode— وضع تغذية منصة التنبؤ: wsأوrestأوdownعندما لا تعمل التغذية. -
quotes_atوfull_scan_at— وقت آخر الأسعار ووقت آخر مسح كامل للأسواق؛ وmarketsوhot_markets— إجمالي الأسواق والأسواق النشطة. -
bookmakers[]— منصات الرهان: ok— هل يعمل الجمع، وeventsوmatched_events— الأحداث إجمالاً والمطابقة لمنصات أخرى، وcurrency— عملة الرهان.
الأفضل تخطّي الحزم التي فيها منصة بحالة down أو ok = false: فقد تكون أسعارها تحرّكت.
التحليلات والأموال الذكية والصفقات والمتداولون
أربع نقاط نهاية في Pro وMax تعكس الشاشات الواردة في دليلي التحليلات والأموال الذكية.
| نقطة النهاية | المعاملات | المحتوى |
|---|---|---|
/predictions/analytics | لا شيء | مؤشرات KPI، وتحركات الأسعار خلال 1h و24h، وتدفقات الأموال، والأسواق التي ستُسوّى قريباً، والأسواق الجديدة |
/predictions/smart-money | لا شيء | مؤشرات KPI، وتدفقات الأموال، وinsiders وconcentration وsmart_vs_price |
/predictions/trades | period, wallet, category, side, min_usd, insider | صفقات Polymarket، الأحدث أولاً |
/predictions/traders | period: 30d (الافتراضي) أو 7d أو all | أفضل 300 متداول على Polymarket حسب PnL |
تصف وسمة insider نمط سلوك المحفظة ولا تثبت شيئاً: فقد يتداول عنوان جديد لمتداول متمرّس بالطريقة نفسها.
معاملات شريط الصفقات؛ ويحدّد period الحد الأدنى:
| المعامل | النوع | وظيفته |
|---|---|---|
period | string | live (الافتراضي) — صفقات من 1,000$، ومن 100$ للمحفظة الذكية؛ وtoday و7d — صفقات الـ taker من 5,000$ |
wallet | string | صفقات محفظة واحدة |
category | string | فئة السوق |
side | string | buy أو sell |
min_usd | number | الحد الأدنى لمبلغ الصفقة، $ |
insider | boolean | true — الصفقات الموسومة insider فقط |
curl -G "https://api.genesisarbitrage.com/v1/predictions/trades" \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX" \
-d period=today -d side=buy -d min_usd=10000
{
"ts": 1794675812,
"wallet": "0x3a1c…f09e",
"tags": ["whale", "smart"],
"title": "Will Bitcoin reach $150k in 2026?",
"outcome": "No",
"side": "buy",
"price": 0.82,
"shares": 30487.8,
"usd": 25000,
"role": "taker",
"insider": false,
"bid_now": 0.81,
"ask_now": 0.83
}
usd = price × shares: 0.82 × 30,487.8 ≈ 25,000. القيمتان bid_now وask_now هما السعران الحاليان للنتيجة: متابعة هذه الصفقة الآن تكلّف 0.83، أي سنتاً واحداً أكثر مما دفعه المتداول.
تعطي /predictions/traders الـ PnL طوال الفترة وخلال 30 و7 أيام (pnl_usd)، وroi_pct، وقيمة won من resolved، ومخطط pnl_series المصغّر. ضع عنواناً من الترتيب في wallet بشريط الصفقات.
كيف تستخدمها
تحقق من خطتك ومن المنصات
تعرض
/account/usageخطتك، و/predictions/platformsمدى حداثة الأسعار.اطلب الحزم مع الفلاتر
يقلّل
min_profit_pctوmax_daysالضجيج والحزم بعيدة التسوية.تحقق من المخاطر والقواعد
مع
rules_differاقرأ قواعد التسوية في المنصتين.لا تستعلم أسرع من حداثة خطتك
استخدم فاصلاً لا يقل عن
meta.freshness_secوأرسلETagفيIf-None-Match: استجابة304لا تستهلك من الحصة.نفّذ الصفقة بنفسك
افتح السوق من
legs[].urlوتحقق من السعر في دفتر أوامره.
الطلب نفسه لـ exact بلغة Python:
import os
from datetime import datetime, timezone
import requests
API = "https://api.genesisarbitrage.com/v1"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}
params = {"mode": "exact", "min_profit_pct": 1, "max_days": 30}
r = requests.get(f"{API}/predictions/arbitrage", headers=HEADERS,
params=params, timeout=10)
if r.status_code == 403:
raise SystemExit("نقطة النهاية أو الوضع ليسا ضمن خطة API الخاصة بك")
r.raise_for_status()
body = r.json()
ts = datetime.fromtimestamp(body["meta"]["updated_at"], timezone.utc)
print(f"الحزم: {body['meta']['count']}, البيانات حتى {ts:%H:%M:%S} UTC")
for b in body["data"]:
print(f"{b['profit_pct']:.2f}% · ${b['profit_usd']:.2f} · "
f"{b['days_left']:.0f} يوم · {b['title'][:40]}")
for leg in b["legs"]:
print(f" {leg['platform']}: {leg['side']} "
f"{leg['outcome']} بسعر {leg['price_avg']}")
if b["risks"]:
print(" المخاطر:", ", ".join(b["risks"]))
على الموقع تجد الحزم نفسها في دليلي مراجحة التنبؤات ووضع Sport؛ أما واجهات المنصات الرسمية فتجدها في مقالتي واجهتا Polymarket وKalshi وأسعار الرهان عبر API.
أسئلة وأجوبة
هل أستطيع شراء العقود أو وضع الرهانات عبر Genesis API؟
لا. يقرأ Genesis API البيانات فقط ولا ينفّذ أوامر: تتداول وتراهن بنفسك على المنصات.
لماذا تكون profit_usd تساوي null في فرصة أربيتراج الرهان؟
لأن ساقاً واحدة على الأقل رهان بأودز، والمنصة لا تنشر حد مبلغه. نسبة الربح معروفة؛ احسب مبلغ كل ساق من stake_unit.
هل يشمل API فرصاً مباشرة؟
لا، قبل المباراة فقط. أسباب ارتفاع مخاطر المباشر موضّحة في مقالة قبل المباراة مقابل المباشر.
أي خطة أحتاج لفرص أربيتراج الرهان؟
Pro أو Max: ففي Start يعيد mode=sport الخطأ 403 plan_restricted. الأسعار في صفحة أسعار Genesis API.