مستندات Genesis API
هرچه برای یکپارچهسازی لازم است: احراز هویت، محدودیتها، اندپوینتها و اسکیمای پاسخ.
آربیتراژ پیشبینی
آربیتراژ بین پلتفرمهای پیشبینی، مانند صفحه «آربیتراژ پیشبینی»: هر بسته با کارمزدها از دفترهای سفارش عبور داده میشود و اندازه معامله، سود به $ و %، APR و ریسکها را نشان میدهد. حالتها: exact — رویدادهای دقیقاً منطبق و dutch — مجموعهای از نتایج در یک پلتفرم (Start، Pro، Max)؛ llm — جفتهای تأییدشده با هوش مصنوعی و sport — سوربتهای بوکمیکر (Pro و Max). وقتی یکی از پایهها بوکمیکر باشد، profit_usd برابر null است: محدودیتهای مبلغ شرط بوکمیکر معلوم نیست.
https://api.genesisarbitrage.com/v1/predictions/arbitrage?mode=exact/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 |
نمونه درخواست
curl "https://api.genesisarbitrage.com/v1/predictions/arbitrage?mode=exact" \ -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
نمونه پاسخ
نمونه پاسخ — یک عنصر data، مقادیر بلند کوتاه شدهاند:
{
"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
{
"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: نتایج تحت پوشش پایه، ضرایب، سهم مبلغ شرط و ارز بوکمیکر |