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/analyticsKPIها، تغییر قیمت‌ها، جریان پولPro، Max
/predictions/smart-moneyمعاملات بزرگ، نهنگ‌ها، الگوهای اینسایدرPro، Max
/predictions/tradesنوار معاملات PolymarketPro، Max
/predictions/traders300 معامله‌گر برتر 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, matchcross، 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[].sideyes یا 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 یک بازار از یک مسابقه است: 2 یا 3 پا روی پلتفرم‌های مختلف که با هم همه نتایج آن را پوشش می‌دهند. پلتفرم‌ها 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_typeWIN — نتیجه، HCP — هندیکپ، TOT — مجموع، BTTS — گل‌زنی هر دو تیم، CS — نتیجه دقیق
period, line, scoreدوره تسویه، خط هندیکپ یا مجموع، نتیجه برای CS
legs[].coversنتایجی که پا پوشش می‌دهد: O — بیشتر، U — کمتر
legs[].oddsضریب اعشاری؛ برای خرید YES یا NO برابر null است
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/tradersperiod: ‏30d (پیش‌فرض)، 7d، all300 معامله‌گر برتر Polymarket بر اساس PnL

برچسب insider الگوی رفتار یک کیف‌پول را توصیف می‌کند و چیزی را ثابت نمی‌کند: آدرس تازه یک معامله‌گر باتجربه هم می‌تواند همین‌طور معامله کند.

پارامترهای نوار معاملات؛ period آستانه را تعیین می‌کند:

پارامترنوعکاربرد
periodstringlive (پیش‌فرض) — معاملات از 1,000$، از 100$ برای کیف‌پول هوشمند؛ today و 7d — تیکرها از 5,000$
walletstringمعاملات یک کیف‌پول
categorystringدسته بازار
sidestringbuy یا sell
min_usdnumberحداقل مبلغ معامله، $
insiderbooleantrue — فقط معاملات دارای برچسب اینسایدر
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 هزینه دارد، یعنی 1 سنت بیشتر از آنچه معامله‌گر پرداخت.

/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 آمده است؛ API رسمی پلتفرم‌ها در مقاله‌های API پلتفرم‌های Polymarket و Kalshi و ضریب‌های شرط‌بندی با API.

پرسش و پاسخ

آیا می‌توانم با Genesis API قرارداد بخرم یا شرط ببندم؟

خیر. Genesis API فقط داده می‌خواند و سفارشی ثبت نمی‌کند: معامله و شرط را خودتان روی پلتفرم‌ها انجام می‌دهید.

چرا profit_usd برای آربیتراژ شرط‌بندی null است؟

دست‌کم یک پا شرط با ضریب است و پلتفرم سقف مبلغ آن را منتشر نمی‌کند. درصد سود معلوم است؛ مبلغ هر پا را از stake_unit حساب کنید.

آیا API آربیتراژ شرط‌بندی زنده را هم دارد؟

خیر، فقط پیش از مسابقه. اینکه چرا زنده ریسک بیشتری دارد در مقاله پیش‌مسابقه یا زنده آمده است.

برای آربیتراژ شرط‌بندی کدام پلن لازم است؟

Pro یا Max: در Start مقدار mode=sport خطای 403 plan_restricted برمی‌گرداند. قیمت‌ها در صفحه قیمت‌های Genesis API است.