توثيق Genesis API
كل ما تحتاجه للتكامل: المصادقة والحدود ونقاط النهاية ومخططات الاستجابة.
التوثيقمراجحة التنبؤات
مراجحة التنبؤات
TrialStartProMax
مراجحة بين منصات التنبؤ، كما في صفحة «مراجحة التنبؤات»: تُمرَّر كل حزمة عبر دفاتر الأوامر مع الرسوم، وتُعرض حجم الصفقة والربح بـ $ و% وAPR والمخاطر. الأوضاع: exact — أحداث متطابقة تماماً وdutch — مجموعة نتائج على منصة واحدة (Start وPro وMax)؛ llm — أزواج تحقق منها الذكاء الاصطناعي وsport — مراجحات شركات الرهان (Pro وMax). عندما تكون إحدى الساقين شركة رهان، تكون profit_usd قيمة null: حدود رهان الشركة غير معروفة.
GET
https://api.genesisarbitrage.com/v1/predictions/arbitrage?mode=exactجرّب الطلب
GET
/v1/predictions/arbitrage?mode=exactيُحفظ المفتاح في متصفحك فقط ولا يُرسل إلى أي جهة سوى الـ API.
الصق مفتاحك وأرسل طلباً — سنعرض استجابة مختصرة.
معاملات الطلب
كل المعاملات اختيارية: بدون مرشحات تعيد نقطة النهاية مجموعة البيانات كاملة.
| المعامل | النوع | الوصف |
|---|---|---|
mode | string | exact (الافتراضي) وdutch — Start وPro وMax؛ وllm وsport — Pro وMax |
category | string | تصفية حسب الفئة |
platform | string | ساق واحدة على الأقل على هذه المنصة أو شركة الرهان؛ عدة قيم — مفصولة بفواصل |
min_profit_pct | number | أدنى ربح، % |
min_profit_usd | number | أدنى ربح، USD (تُتخطى الصفوف ذات profit_usd = null) |
min_apr | number | أدنى APR، % |
max_days | number | أقصى عدد أيام حتى الحسم |
sport / league | string | الرياضة والدوري لـ mode=sport، تطابق تام. رموز الرياضات: soccer, basketball, hockey, american_football, baseball, tennis, mma, boxing, volleyball, handball, table_tennis, cricket, rugby, darts, snooker, futsal, esports_cs2, esports_dota2, esports_lol, esports_valorant, esports_other |
مثال طلب
bash
curl "https://api.genesisarbitrage.com/v1/predictions/arbitrage?mode=exact" \ -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
مثال استجابة
مثال على الاستجابة — عنصر بيانات واحد، مع اختصار القيم الطويلة:
json
{
"id": "x:exact:kalshi:KXFRENCHPRES-27-JCAS~polymarket:0x8c1f…a93a",
"kind": "cross",
"match": "exact",
"title": "Will Jean Castex win the 2027 French presidential election?",
"category": "Elections",
"event_id": null,
"group_id": "g:cd2ffb419bd1",
"ends_at": 1843308000,
"days_left": 562.87,
"starts_at": null,
"size_usd": 107175.08,
"fees_usd": 28.08,
"profit_usd": 153.69,
"profit_pct": 0.14,
"apr_pct": 0.1,
"edge_cents": 0.18,
"shares": 107356.85,
"risks": ["rules_differ", "end_mismatch"],
"first_seen": 1794526832,
"updated_at": 1794675861,
"legs": [
{
"market": "polymarket:0x8c1f…a93a",
"platform": "polymarket",
"side": "yes",
"outcome": "Jean Castex",
"price_best": 0.001,
"price_avg": 0.0013,
"price_worst": 0.002,
"shares": 107356.85,
"cost_usd": 140.3,
"fee_usd": 5.6,
"url": "https://polymarket.com/event/next-french-presidential-election"
},
{
"market": "kalshi:KXFRENCHPRES-27-JCAS",
"platform": "kalshi",
"side": "no",
"outcome": "No",
"price_best": 0.997,
"price_avg": 0.997,
"price_worst": 0.997,
"shares": 107356.85,
"cost_usd": 107034.78,
"fee_usd": 22.48,
"url": "https://kalshi.com/events/KXFRENCHPRES-27"
}
]
}مثال على صف mode=sport
json
{
"id": "s:8812:RT: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", "url": "https://polymarket.com/…" },
{ "platform": "fonbet", "side": "bet", "outcome": "Under 2.5", "covers": ["U"],
"odds": 2.12, "stake_unit": 0.471698, "currency": "RUB", "url": "https://www.fon.bet/…" }
]
}حقول الاستجابة
| الحقل | النوع | الوصف |
|---|---|---|
id | string | معرّف ثابت للحزمة |
kind | string | cross — زوج منصات، dutch — مجموعة نتائج، sport — مراجحة شركات الرهان |
match | string | exact أو llm أو sport |
title / category | string | عنوان الحدث أو السوق والفئة |
event_id / group_id | string | null | معرّفات الحدث ومجموعة الأزواج |
ends_at / days_left / starts_at | number | null | وقت الحسم والأيام حتى الحسم وبداية المباراة (ثواني unix) |
size_usd / fees_usd | number | حجم الصفقة والرسوم، USD |
profit_usd / profit_pct | number | null | الربح بـ USD و% من الرهان؛ profit_usd = null — ساق شركة رهان |
apr_pct | number | null | APR، % (null عندما تقل المدة عن يوم) |
edge_cents | number | ميزة السعر، سنتات للسهم |
shares | number | الأسهم في الحزمة |
risks | string[] | رموز المخاطر: قواعد مختلفة، وتواريخ حسم مختلفة، وغيرها |
first_seen / updated_at | number | وقت ظهور الحزمة وتحديثها |
legs[].market / platform | string | سوق الساق والمنصة أو شركة الرهان |
legs[].side / outcome | string | ما يُشترى — yes أو no أو bet (رهان شركة الرهان) — والنتيجة |
legs[].price_best / price_avg / price_worst | number | أفضل سعر ومتوسطه وأسوأه عند المرور عبر الدفتر |
legs[].shares / cost_usd / fee_usd / url | mixed | أسهم الساق وتكلفتها ورسومها ورابطها |
sport / league / teams / flags | mixed | لـ sport: الرياضة والدوري والفرق والأعلام |
market_type / period / line / score | mixed | لـ sport: نوع السوق (WIN وHCP وTOT وBTTS وCS) والفترة والخط والنتيجة |
legs[].covers / odds / stake_unit / currency | mixed | لـ sport: النتائج التي تغطيها الساق والاحتمالات وحصة الرهان وعملة شركة الرهان |