Genesis Arbitrage

Genesis Arbitrage · · 阅读约 21 分钟

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/tradesPolymarket 成交流Pro、Max
/predictions/traders按 PnL 排名的前 300 名 Polymarket 交易者Pro、Max

在 Trial 上,六个接口都返回 403 plan_restricted;在 Start 上,mode=llm 和 mode=sport 的请求也一样。响应格式见响应与错误指南,配额见限额指南。

预测套利:模式

mode 参数决定 /predictions/arbitrage 返回哪类组合。

mode返回内容kind套餐
exact两个平台上的同一事件,默认值crossStart、Pro、Max
dutch同一平台上一个事件的一组结果dutchStart、Pro、Max
llm经 AI 验证的事件配对crossPro、Max
sport比赛上的博彩套利sportPro、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

筛选参数

参数类型作用
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稳定的 ID,组合出现和更新的时间
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。各腿 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"
    }
  ]
}

最好跳过平台为 down 或 ok = false 的组合:它们的价格可能已经变动。

分析、聪明钱、成交和交易者

Pro 和 Max 上的四个接口对应分析和聪明钱指南中的页面。

接口参数内容
/predictions/analytics无KPI、1 小时和 24 小时价格变动、资金流向、即将结算的市场、新市场
/predictions/smart-money无KPI、资金流向、insiders、concentration、smart_vs_price
/predictions/tradesperiod、wallet、category、side、min_usd、insiderPolymarket 成交,最新的在前
/predictions/tradersperiod:30d(默认)、7d、all按 PnL 排名的前 300 名 Polymarket 交易者

insider 标签描述的是钱包的行为模式,并不能证明什么:经验丰富的交易者的新地址也可能以同样方式交易。

成交流参数;period 决定门槛:

参数类型作用
periodstringlive(默认)——$1,000 起的成交,聪明钱包 $100 起;today 和 7d——$5,000 起的 taker
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 给出全部时间、30 天和 7 天的 PnL(pnl_usd)、roi_pct、resolved 中的 won 以及 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']} 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 价格页面。