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 | 按 PnL 排名的前 300 名 Polymarket 交易者 | 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 | 经 AI 验证的事件配对 | cross | Pro、Max |
sport | 比赛上的博彩套利 | sport | Pro、Max |
利润已按平台订单簿和手续费算好。请求利润至少 1%、30 天内结算的 exact 组合:
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 | 稳定的 ID,组合出现和更新的时间 |
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。各腿 stake unit 之和为 0.505 + 0.471698 = 0.976698,小于 1,因此利润为 1 / 0.976698 − 1 = 2.39%。要分配你自己的资金,用 该腿下注额 = 总额 × stake_unit / Σ stake_unit。
size_usd 是预测平台订单簿能够承接的买入金额。$1,000 按 0.505 可买入 1,000 / 0.505 ≈ 1,980.2 份“Over 2.5”的 YES。要让“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、1 小时和 24 小时价格变动、资金流向、即将结算的市场、新市场 |
/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 | 按 PnL 排名的前 300 名 Polymarket 交易者 |
insider 标签描述的是钱包的行为模式,并不能证明什么:经验丰富的交易者的新地址也可能以同样方式交易。
成交流参数;period 决定门槛:
| 参数 | 类型 | 作用 |
|---|---|---|
period | string | live(默认)——$1,000 起的成交,聪明钱包 $100 起;today 和 7d——$5,000 起的 taker |
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 给出全部时间、30 天和 7 天的 PnL(pnl_usd)、roi_pct、resolved 中的 won 以及 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']} at {leg['price_avg']}")
if b["risks"]:
print(" 风险:", ", ".join(b["risks"]))
在网站上,同样的组合见预测套利和 Sport 模式指南;各平台的官方 API 见 Polymarket 和 Kalshi API 以及通过 API 获取博彩赔率两篇文章。
常见问题
能通过 Genesis API 购买合约或下注吗?
不能。Genesis API 只读取数据,不下任何订单:交易和下注由你自己在平台上完成。
为什么博彩套利的 profit_usd 是 null?
至少有一条腿是赔率投注,而平台不公布其下注上限。利润百分比是已知的;请用 stake_unit 算出每条腿的金额。
API 包含滚球博彩套利吗?
不包含,仅限赛前。滚球为什么风险更高,见赛前与滚球一文。
博彩套利需要哪个套餐?
Pro 或 Max:在 Start 上,mode=sport 返回 403 plan_restricted。价格见 Genesis API 价格页面。