Genesis API 文档
接入所需的一切:认证、限额、接口和响应结构。
文档Prediction Arbitrage
Prediction Arbitrage
TrialStartProMax
预测平台之间的套利,与「预测套利」页面一致:每个组合都会按订单簿逐档计算并计入手续费,显示交易规模、以 $ 和 % 计的利润、APR 以及风险。模式:exact——完全匹配的事件,dutch——单个平台上的一组结果(Start、Pro、Max);llm——经 AI 验证的配对,sport——博彩公司 surebet(Pro 和 Max)。当某条腿是博彩公司时,profit_usd 为 null:博彩公司的下注限额未知。
GET
https://api.genesisarbitrage.com/v1/predictions/arbitrage?mode=exact在线试用
GET
/v1/predictions/arbitrage?mode=exact密钥仅保存在你的浏览器中,除 API 外不会发送到任何地方。
粘贴你的密钥并发送请求——我们会显示截断后的响应。
查询参数
所有参数均为可选:不带筛选条件时,接口返回完整数据集。
| 参数 | 类型 | 说明 |
|---|---|---|
mode | string | exact(默认)和 dutch——Start、Pro、Max;llm 和 sport——Pro 和 Max |
category | string | 按类别筛选 |
platform | string | 至少有一条腿在此平台或博彩公司;多个用逗号分隔 |
min_profit_pct | number | 最小利润,% |
min_profit_usd | number | 最小利润,USD(profit_usd = null 的行会被跳过) |
min_apr | number | 最小 APR,% |
max_days | number | 距离结算最多这么多天 |
sport / league | string | 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"
响应示例
响应示例——一条数据,较长的值已缩短:
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/…" }
]
}响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
id | string | 组合的稳定 id |
kind | string | cross——平台配对,dutch——结果集,sport——博彩公司 surebet |
match | string | exact、llm 或 sport |
title / category | string | 事件或市场标题及类别 |
event_id / group_id | string | null | 事件和配对组的 id |
ends_at / days_left / starts_at | number | null | 结算时间、距结算的天数和比赛开始时间(unix 秒) |
size_usd / fees_usd | number | 交易规模和手续费,USD |
profit_usd / profit_pct | number | null | 以 USD 计的利润和占本金的 %;profit_usd = null——博彩公司腿 |
apr_pct | number | null | APR,%(不足一天时为 null) |
edge_cents | number | 价格优势,每份额美分 |
shares | number | 组合中的份额数 |
risks | string[] | 风险代码:规则不同、结算日期不同等 |
first_seen / updated_at | number | 组合出现和更新的时间 |
legs[].market / platform | string | 该腿的市场及平台或博彩公司 |
legs[].side / outcome | string | 买入什么——yes、no 或 bet(博彩公司下注)——以及结果 |
legs[].price_best / price_avg / price_worst | number | 按订单簿逐档成交时的最优、平均和最差价格 |
legs[].shares / cost_usd / fee_usd / url | mixed | 该腿的份额、成本、手续费和链接 |
sport / league / teams / flags | mixed | 用于 sport:运动项目、联赛、球队、标志 |
market_type / period / line / score | mixed | 用于 sport:市场类型(WIN、HCP、TOT、BTTS、CS)、时段、盘口线、比分 |
legs[].covers / odds / stake_unit / currency | mixed | 用于 sport:该腿覆盖的结果、赔率、下注占比和博彩公司的货币 |