بازارهای پیشبینی و آربیتراژ شرطبندی در 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 | نوار معاملات Polymarket | Pro، Max |
/predictions/traders | 300 معاملهگر برتر Polymarket بر اساس PnL | Pro، Max |
در Trial هر شش اندپوینت 403 plan_restricted برمیگردانند؛ در Start درخواستهای با mode=llm و mode=sport هم همینطورند. قالب پاسخ در راهنمای پاسخها و خطاها و سهمیه در راهنمای محدودیتها آمده است.
آربیتراژ پیشبینی: حالتها
پارامتر mode تعیین میکند /predictions/arbitrage کدام بستهها را برگرداند.
mode | چه میگیرید | kind | پلنها |
|---|---|---|---|
exact | یک رویداد روی دو پلتفرم، پیشفرض | cross | Start، Pro، Max |
dutch | مجموعهای از نتایج یک رویداد روی یک پلتفرم | dutch | Start، Pro، Max |
llm | جفترویدادهای تأییدشده با هوش مصنوعی | cross | Pro، Max |
sport | آربیتراژ شرطبندی روی مسابقهها | sport | Pro، 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
فیلترها
| پارامتر | نوع | کاربرد |
|---|---|---|
mode | string | exact (پیشفرض)، dutch، llm یا sport |
category | string | دسته، مانند فیلد category |
platform | string | دستکم یک پا روی این پلتفرم؛ چند پلتفرم با ویرگول جدا میشود |
min_profit_pct | number | حداقل سود، % |
min_profit_usd | number | حداقل سود، $؛ ردیفهایی با profit_usd = null رد میشوند |
min_apr | number | حداقل APR، % |
max_days | number | حداکثر روز تا تسویه |
sport, league | string | ورزش و لیگ، برای 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 یک بازار از یک مسابقه است: 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_type | WIN — نتیجه، 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"
}
]
}
platforms[].mode— حالت فید پلتفرم پیشبینی:ws،restیاdownوقتی فید کار نمیکند.quotes_atوfull_scan_at— زمان آخرین قیمتها و آخرین پویش کامل بازارها؛marketsوhot_markets— کل بازارها و بازارهای داغ.bookmakers[]— پلتفرمهای شرطبندی:ok— آیا جمعآوری کار میکند،eventsوmatched_events— کل رویدادها و رویدادهای منطبق با پلتفرمهای دیگر،currency— ارز شرطبندی.
بستههایی را که پلتفرمی با down یا ok = false دارند بهتر است رد کنید: ممکن است قیمتهایشان تغییر کرده باشد.
تحلیل، پول هوشمند، معاملات و معاملهگران
چهار اندپوینت در Pro و Max، صفحههای راهنمای تحلیل و پول هوشمند را بازتاب میدهند.
| اندپوینت | پارامترها | محتوا |
|---|---|---|
/predictions/analytics | ندارد | KPIها، تغییر قیمت در 1h و 24h، جریان پول، بازارهای نزدیک به تسویه، بازارهای جدید |
/predictions/smart-money | ندارد | KPIها، جریان پول، insiders، concentration، smart_vs_price |
/predictions/trades | period, wallet, category, side, min_usd, insider | معاملات Polymarket، جدیدترین اول |
/predictions/traders | period: 30d (پیشفرض)، 7d، all | 300 معاملهگر برتر Polymarket بر اساس PnL |
برچسب insider الگوی رفتار یک کیفپول را توصیف میکند و چیزی را ثابت نمیکند: آدرس تازه یک معاملهگر باتجربه هم میتواند همینطور معامله کند.
پارامترهای نوار معاملات؛ period آستانه را تعیین میکند:
| پارامتر | نوع | کاربرد |
|---|---|---|
period | string | live (پیشفرض) — معاملات از 1,000$، از 100$ برای کیفپول هوشمند؛ today و 7d — تیکرها از 5,000$ |
wallet | string | معاملات یک کیفپول |
category | string | دسته بازار |
side | string | buy یا sell |
min_usd | number | حداقل مبلغ معامله، $ |
insider | boolean | true — فقط معاملات دارای برچسب اینسایدر |
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 نوار معاملات بگذارید.
نحوه استفاده
پلن و پلتفرمها را بررسی کنید
/account/usageپلن شما را نشان میدهد و/predictions/platformsتازگی قیمتها را.بستهها را با فیلتر بخواهید
min_profit_pctوmax_daysنویز و بستههای با تسویه دور را کم میکنند.ریسکها و قواعد را بررسی کنید
با
rules_differقواعد تسویه هر دو پلتفرم را بخوانید.سریعتر از تازگی پلن خود پرسوجو نکنید
فاصلهای دستکم برابر
meta.freshness_secبگذارید وETagرا درIf-None-Matchبرگردانید: پاسخ304از سهمیه کم نمیکند.معامله را خودتان انجام دهید
بازار را از
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 است.