مستندات Genesis API

هرچه برای یکپارچه‌سازی لازم است: احراز هویت، محدودیت‌ها، اندپوینت‌ها و اسکیمای پاسخ.

مستنداتآربیتراژ پیش‌بینی

آربیتراژ پیش‌بینی

TrialStartProMax

آربیتراژ بین پلتفرم‌های پیش‌بینی، مانند صفحه «آربیتراژ پیش‌بینی»: هر بسته با کارمزدها از دفترهای سفارش عبور داده می‌شود و اندازه معامله، سود به $ و %، APR و ریسک‌ها را نشان می‌دهد. حالت‌ها: exact — رویدادهای دقیقاً منطبق و dutch — مجموعه‌ای از نتایج در یک پلتفرم (Start، Pro، Max)؛ llm — جفت‌های تأییدشده با هوش مصنوعی و sport — سوربت‌های بوکمیکر (Pro و Max). وقتی یکی از پایه‌ها بوکمیکر باشد، profit_usd برابر null است: محدودیت‌های مبلغ شرط بوکمیکر معلوم نیست.

GEThttps://api.genesisarbitrage.com/v1/predictions/arbitrage?mode=exact
امتحان درخواست
GET/v1/predictions/arbitrage?mode=exact

کلید فقط در مرورگر شما ذخیره می‌شود و جز به API جایی فرستاده نمی‌شود.

کلید را بچسبانید و درخواست بزنید — پاسخ خلاصه‌شده را نشان می‌دهیم.

پارامترهای درخواست

همه پارامترها اختیاری‌اند: بدون فیلتر، اندپوینت کل مجموعه داده را برمی‌گرداند.

پارامترنوعتوضیح
modestringexact (پیش‌فرض) و dutch — Start، Pro، Max؛ llm و sport — Pro و Max
categorystringفیلتر بر اساس دسته
platformstringدست‌کم یک پایه در این پلتفرم یا بوکمیکر؛ چندتا با ویرگول
min_profit_pctnumberحداقل سود، %
min_profit_usdnumberحداقل سود، USD (ردیف‌های با profit_usd = null کنار گذاشته می‌شوند)
min_aprnumberحداقل APR، %
max_daysnumberحداکثر این تعداد روز تا تسویه
sport / leaguestringرشته ورزشی و لیگ برای 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"

نمونه پاسخ

نمونه پاسخ — یک عنصر data، مقادیر بلند کوتاه شده‌اند:

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/…" }
  ]
}

فیلدهای پاسخ

فیلدنوعتوضیح
idstringشناسه پایدار بسته
kindstringcross — جفت پلتفرم، dutch — مجموعه نتایج، sport — سوربت بوکمیکر
matchstringexact، llm یا sport
title / categorystringعنوان رویداد یا بازار و دسته
event_id / group_idstring | nullشناسه‌های رویداد و گروه جفت
ends_at / days_left / starts_atnumber | nullزمان تسویه، روزهای مانده تا تسویه و شروع مسابقه (ثانیه unix)
size_usd / fees_usdnumberاندازه معامله و کارمزدها، USD
profit_usd / profit_pctnumber | nullسود به USD و % از مبلغ؛ profit_usd = null — پایه بوکمیکر
apr_pctnumber | nullAPR، % (در کمتر از یک روز null)
edge_centsnumberمزیت قیمتی، سنت به‌ازای هر سهم
sharesnumberسهم‌های بسته
risksstring[]کدهای ریسک: قوانین متفاوت، تاریخ‌های تسویه متفاوت و غیره
first_seen / updated_atnumberزمان پیدایش و به‌روزرسانی بسته
legs[].market / platformstringبازار پایه و پلتفرم یا بوکمیکر
legs[].side / outcomestringچه چیزی بخریم — yes، no یا bet (شرط بوکمیکر) — و نتیجه
legs[].price_best / price_avg / price_worstnumberبهترین، میانگین و بدترین قیمت هنگام عبور از دفتر
legs[].shares / cost_usd / fee_usd / urlmixedسهم‌ها، هزینه، کارمزد و لینک پایه
sport / league / teams / flagsmixedبرای sport: ورزش، لیگ، تیم‌ها، پرچم‌ها
market_type / period / line / scoremixedبرای sport: نوع بازار (WIN، HCP، TOT، BTTS، CS)، دوره، خط، نتیجه
legs[].covers / odds / stake_unit / currencymixedبرای sport: نتایج تحت پوشش پایه، ضرایب، سهم مبلغ شرط و ارز بوکمیکر