Genesis API Documentation
Everything you need to integrate: authentication, limits, endpoints and response schemas.
Prediction Arbitrage
Arbitrage across prediction platforms, as on the Β«Prediction arbitrageΒ» page: each bundle is walked through the order books with fees and shows the trade size, profit in $ and %, APR and risks. Modes: exact β exactly matched events and dutch β an outcome set on one platform (Start, Pro, Max); llm β AI-verified pairs and sport β bookmaker surebets (Pro and Max). When a leg is a bookmaker, profit_usd is null: the bookmaker's stake limits are unknown.
https://api.genesisarbitrage.com/v1/predictions/arbitrage?mode=exact/v1/predictions/arbitrage?mode=exactThe key is stored only in your browser and is sent nowhere except the API.
Paste your key and send a request β we'll show a truncated response.
Query parameters
All parameters are optional: without filters the endpoint returns the full dataset.
| Parameter | Type | Description |
|---|---|---|
mode | string | exact (default) and dutch β Start, Pro, Max; llm and sport β Pro and Max |
category | string | Filter by category |
platform | string | At least one leg on this platform or bookmaker; several β comma-separated |
min_profit_pct | number | Minimum profit, % |
min_profit_usd | number | Minimum profit, USD (rows with profit_usd = null are skipped) |
min_apr | number | Minimum APR, % |
max_days | number | At most this many days to resolution |
sport / league | string | Sport and league for mode=sport, exact match. Sport codes: 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 |
Example request
curl "https://api.genesisarbitrage.com/v1/predictions/arbitrage?mode=exact" \ -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
Example response
Response example β one data entry, long values shortened:
{
"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"
}
]
}Example mode=sport row
{
"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/β¦" }
]
}Response fields
| Field | Type | Description |
|---|---|---|
id | string | Stable bundle id |
kind | string | cross β platform pair, dutch β outcome set, sport β bookmaker surebet |
match | string | exact, llm or sport |
title / category | string | Event or market title and category |
event_id / group_id | string | null | Event and pair-group ids |
ends_at / days_left / starts_at | number | null | Resolution time, days to resolution and match start (unix seconds) |
size_usd / fees_usd | number | Trade size and fees, USD |
profit_usd / profit_pct | number | null | Profit in USD and % of the stake; profit_usd = null β a bookmaker leg |
apr_pct | number | null | APR, % (null when under one day) |
edge_cents | number | Price edge, cents per share |
shares | number | Shares in the bundle |
risks | string[] | Risk codes: different rules, different resolution dates, etc. |
first_seen / updated_at | number | When the bundle appeared and was updated |
legs[].market / platform | string | The leg's market and platform or bookmaker |
legs[].side / outcome | string | What to buy β yes, no or bet (bookmaker stake) β and the outcome |
legs[].price_best / price_avg / price_worst | number | Best, average and worst price when walking the book |
legs[].shares / cost_usd / fee_usd / url | mixed | The leg's shares, cost, fee and link |
sport / league / teams / flags | mixed | For sport: sport, league, teams, flags |
market_type / period / line / score | mixed | For sport: market type (WIN, HCP, TOT, BTTS, CS), period, line, score |
legs[].covers / odds / stake_unit / currency | mixed | For sport: outcomes the leg covers, odds, stake share and the bookmaker's currency |