Genesis Arbitrage

Genesis Arbitrage · · 11 دقائق قراءة

أسواق التنبؤ وأربيتراج الرهان في 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شريط صفقات PolymarketPro وMax
/predictions/tradersأفضل 300 متداول على Polymarket حسب PnLPro وMax

في خطة Trial تعيد النقاط الست كلها 403 plan_restricted؛ وفي Start يحدث الأمر نفسه للطلبات بـ mode=llm وmode=sport. صيغة الاستجابة موضّحة في دليل الاستجابات والأخطاء، والحصة في دليل الحدود.

مراجحة التنبؤات: الأوضاع

يحدّد المعامل mode أي الحزم تعيدها /predictions/arbitrage.

modeما تحصل عليهkindالخطط
exactالحدث نفسه على منصتين، وهو الافتراضيcrossStart وPro وMax
dutchمجموعة نتائج لحدث واحد على منصة واحدةdutchStart وPro وMax
llmأزواج أحداث تحقّق منها الذكاء الاصطناعيcrossPro وMax
sportفرص أربيتراج الرهان على المبارياتsportPro و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

الفلاتر

المعاملالنوعوظيفته
modestringexact (الافتراضي) أو dutch أو llm أو sport
categorystringالفئة، كما في حقل category
platformstringساق واحدة على الأقل على هذه المنصة؛ وعند عدة منصات تُفصل بفواصل
min_profit_pctnumberالحد الأدنى للربح، %
min_profit_usdnumberالحد الأدنى للربح، $؛ تُتخطى الصفوف التي فيها profit_usd = null
min_aprnumberالحد الأدنى لـ APR، %
max_daysnumberأقصى عدد أيام حتى التسوية
sport, leaguestringالرياضة والدوري، لوضع 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"
    }
  ]
}

الأفضل تخطّي الحزم التي فيها منصة بحالة down أو ok = false: فقد تكون أسعارها تحرّكت.

التحليلات والأموال الذكية والصفقات والمتداولون

أربع نقاط نهاية في Pro وMax تعكس الشاشات الواردة في دليلي التحليلات والأموال الذكية.

نقطة النهايةالمعاملاتالمحتوى
/predictions/analyticsلا شيءمؤشرات KPI، وتحركات الأسعار خلال 1h و24h، وتدفقات الأموال، والأسواق التي ستُسوّى قريباً، والأسواق الجديدة
/predictions/smart-moneyلا شيءمؤشرات KPI، وتدفقات الأموال، وinsiders وconcentration وsmart_vs_price
/predictions/tradesperiod, wallet, category, side, min_usd, insiderصفقات Polymarket، الأحدث أولاً
/predictions/traders‏period: ‏30d (الافتراضي) أو 7d أو allأفضل 300 متداول على Polymarket حسب PnL

تصف وسمة insider نمط سلوك المحفظة ولا تثبت شيئاً: فقد يتداول عنوان جديد لمتداول متمرّس بالطريقة نفسها.

معاملات شريط الصفقات؛ ويحدّد period الحد الأدنى:

المعاملالنوعوظيفته
periodstring‏live (الافتراضي) — صفقات من 1,000$، ومن 100$ للمحفظة الذكية؛ وtoday و7d — صفقات الـ taker من 5,000$
walletstringصفقات محفظة واحدة
categorystringفئة السوق
sidestring‏buy أو sell
min_usdnumberالحد الأدنى لمبلغ الصفقة، $
insiderboolean‏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 بشريط الصفقات.

كيف تستخدمها

  1. تحقق من خطتك ومن المنصات

    تعرض /account/usage خطتك، و/predictions/platforms مدى حداثة الأسعار.

  2. اطلب الحزم مع الفلاتر

    يقلّل min_profit_pct وmax_days الضجيج والحزم بعيدة التسوية.

  3. تحقق من المخاطر والقواعد

    مع rules_differ اقرأ قواعد التسوية في المنصتين.

  4. لا تستعلم أسرع من حداثة خطتك

    استخدم فاصلاً لا يقل عن meta.freshness_sec وأرسل ETag في If-None-Match: استجابة 304 لا تستهلك من الحصة.

  5. نفّذ الصفقة بنفسك

    افتح السوق من 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.