Marchés prédictifs et surebets dans Genesis API : endpoints, filtres et champs
En bref
- Six endpoints : arbitrage prédictif et état des plateformes dès le plan Start ; analytique, smart money, grosses transactions et classement des traders avec Pro et Max.
- Les lots d’arbitrage sont chiffrés à partir des carnets d’ordres, frais compris : taille de la transaction, profit en $ et en %, APR, jours avant le règlement et codes de risque.
- Le mode sport renvoie des surebets sur 13 plateformes, avant-match uniquement. Quand une jambe est un pari à cote, profit_usd vaut null, car la limite de mise de ce pari est inconnue.
Genesis API fournit les données des marchés prédictifs via six endpoints GET : lots d’arbitrage entre Polymarket, Kalshi, Limitless, Predict.fun et Opinion, surebets sur 13 plateformes, état des plateformes, analytique, smart money, grosses transactions et classement des traders. Ce sont les données des pages Arbitrage prédictif, Analytique et Smart Money, au format JSON. Vous pouvez en tirer un bot, un tableau de bord ou des alertes ; les transactions et les paris, c’est vous qui les passez sur les plateformes.
Endpoints et plans
| Endpoint | Ce qu’il renvoie | Plans API |
|---|---|---|
/predictions/arbitrage | Lots d’arbitrage et surebets | Start, Pro, Max ; modes llm et sport — Pro, Max |
/predictions/platforms | État des plateformes | Start, Pro, Max |
/predictions/analytics | KPI, variations de prix, flux d’argent | Pro, Max |
/predictions/smart-money | Grosses transactions, baleines, schémas d’initiés | Pro, Max |
/predictions/trades | Flux des transactions Polymarket | Pro, Max |
/predictions/traders | Top 300 des traders Polymarket par PnL | Pro, Max |
Avec Trial, les six renvoient 403 plan_restricted ; avec Start, c’est aussi le cas des requêtes avec mode=llm et mode=sport. Le format des réponses est décrit dans le guide réponses et erreurs, le quota dans le guide des limites.
Arbitrage prédictif : les modes
Le paramètre mode choisit les lots que renvoie /predictions/arbitrage.
mode | Ce que vous obtenez | kind | Plans |
|---|---|---|---|
exact | Le même événement sur deux plateformes, valeur par défaut | cross | Start, Pro, Max |
dutch | Un ensemble d’issues d’un événement sur une plateforme | dutch | Start, Pro, Max |
llm | Paires d’événements vérifiées par IA | cross | Pro, Max |
sport | Surebets sur des matchs | sport | Pro, Max |
Le profit est déjà calculé à travers les carnets d’ordres des plateformes, frais compris. Requête des lots exact avec au moins 1 % de profit et un règlement sous 30 jours :
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
Filtres
| Paramètre | Type | Effet |
|---|---|---|
mode | string | exact (par défaut), dutch, llm ou sport |
category | string | Catégorie, comme dans le champ category |
platform | string | Au moins une jambe sur cette plateforme ; plusieurs, séparées par des virgules |
min_profit_pct | number | Profit minimal, % |
min_profit_usd | number | Profit minimal, $ ; les lignes avec profit_usd = null sont ignorées |
min_apr | number | APR minimal, % |
max_days | number | Au plus ce nombre de jours avant le règlement |
sport, league | string | Sport et ligue, pour mode=sport |
Les filtres sont facultatifs et se combinent. Écrivez la plateforme comme dans legs[].platform : polymarket, kalshi, fonbet. Un mode inconnu renvoie 400 bad_request.
Un lot et ses jambes
Exemple illustratif : une ligne mode=exact tirée de la documentation, abrégée.
{
"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"
}
]
}
| Champ | Signification |
|---|---|
id, first_seen, updated_at | Identifiant stable, date d’apparition et de mise à jour du lot |
kind, match | cross, dutch ou sport ; match vaut exact, llm ou sport |
title, category | Événement ou marché et sa catégorie |
ends_at, days_left, starts_at | Moment du règlement, jours avant le règlement, début du match |
size_usd, fees_usd, shares | Taille de la transaction et frais en $, nombre de parts |
profit_usd, profit_pct, apr_pct | Profit en $ et en %, APR ; apr_pct vaut null sous un jour |
edge_cents, risks | Avantage de prix en cents par part, codes de risque |
legs[].platform, market, outcome | Plateforme, marché et issue de la jambe |
legs[].side | yes ou no — ce qu’il faut acheter ; bet — un pari à cote |
legs[].price_best, price_avg, price_worst | Meilleur prix, prix moyen et pire prix en parcourant le carnet |
legs[].shares, cost_usd, fee_usd, url | Parts, coût, frais et lien du marché de la jambe |
Le prix d’une jambe est une fraction de dollar : une part rapporte 1 $ si son issue l’emporte, donc 0.997 correspond à 99,7 ¢. Si les deux plateformes règlent de la même façon, une jambe gagne quoi qu’il arrive, et shares est la somme que vous recevez. rules_differ signale que les règles de règlement des plateformes peuvent différer ; end_mismatch, que leurs dates de règlement diffèrent.
Dans l’exemple, 107 356,85 − 107 175,08 − 28,08 = 153,69 $ de profit, soit 153,69 / 107 203,16 = 0,14 %. L’argent est immobilisé 562,87 jours jusqu’au règlement : le taux annuel ressort à 0,14 × 365 / 562,87 ≈ 0,1 %. Le filtre max_days écarte ces lots.
Mode sport : surebets
Une ligne sport correspond à un marché d’un match : 2 ou 3 jambes sur des plateformes différentes qui couvrent ensemble toutes les issues. Il y a 13 plateformes : Polymarket, Kalshi, Predict.fun et 10 plateformes de paris — Fonbet, Betcity, Olimpbet, Marathon, 5051X, Melbet, Winline, BC.Game, EGB et Dafa Sports. Avant-match uniquement : dès que le match commence, la surebet quitte la liste.
Exemple illustratif : une ligne mode=sport tirée de la documentation, avec des prix recalculés.
{
"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"
}
]
}
| Champ | Signification |
|---|---|
sport, league, teams, flags | Sport, ligue, équipes, étiquettes du match |
market_type | WIN — résultat, HCP — handicap, TOT — total, BTTS — les deux équipes marquent, CS — score exact |
period, line, score | Période de règlement, ligne de handicap ou de total, score pour CS |
legs[].covers | Issues couvertes par la jambe : O — plus de, U — moins de |
legs[].odds | Cote décimale ; null pour un achat YES ou NO |
legs[].stake_unit | Part de la mise : combien placer sur la jambe pour obtenir 1 $ en cas de gain, frais compris |
legs[].currency | La devise de la plateforme |
Pour un pari à cote, stake_unit = 1 / odds : 1 / 2,12 = 0,471698. Les parts de mise de toutes les jambes totalisent 0,505 + 0,471698 = 0,976698, soit moins de 1, d’où un profit de 1 / 0,976698 − 1 = 2,39 %. Pour répartir votre propre somme, utilisez mise de la jambe = somme × stake_unit / Σ stake_unit.
size_usd est le montant d’achats sur les plateformes prédictives que leurs carnets d’ordres peuvent absorber. 1 000 $ à 0,505 achètent 1 000 / 0,505 ≈ 1 980,2 parts YES de « Over 2.5 ». Pour que « Under 2.5 » rapporte la même somme, la mise chez Fonbet est de 1 980,2 × 0,471698 ≈ 934,06 $.
Fonbet prend les paris en roubles (currency = RUB) : convertissez la somme à votre propre taux, car le change n’entre pas dans profit_pct. Ici profit_usd vaut null, car la plateforme de paris ne publie pas sa limite de mise.
État des plateformes
/predictions/platforms indique la fraîcheur des données d’arbitrage. Il ne prend aucun paramètre ; data contient deux listes :
{
"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— mode du flux de la plateforme prédictive :ws,rest, oudownquand le flux ne fonctionne pas.quotes_atetfull_scan_at— heure des dernières cotations et du dernier balayage complet des marchés ;marketsethot_markets— marchés au total et marchés actifs.bookmakers[]— plateformes de paris :ok— si la collecte fonctionne,eventsetmatched_events— événements au total et rapprochés d’autres plateformes,currency— la devise des paris.
Mieux vaut ignorer les lots dont une plateforme est en down ou dont ok = false : leurs prix ont pu bouger.
Analytique, smart money, transactions et traders
Quatre endpoints réservés à Pro et Max reprennent les écrans des guides Analytique et Smart Money.
| Endpoint | Paramètres | Contenu |
|---|---|---|
/predictions/analytics | aucun | KPI, variations de prix sur 1 h et 24 h, flux d’argent, marchés bientôt réglés, nouveaux marchés |
/predictions/smart-money | aucun | KPI, flux d’argent, insiders, concentration, smart_vs_price |
/predictions/trades | period, wallet, category, side, min_usd, insider | Transactions Polymarket, les plus récentes d’abord |
/predictions/traders | period : 30d (par défaut), 7d, all | Top 300 des traders Polymarket par PnL |
L’étiquette insider décrit le schéma de comportement d’un wallet et ne prouve rien : une nouvelle adresse d’un trader expérimenté peut trader de la même façon.
Paramètres du flux de transactions ; period fixe le seuil :
| Paramètre | Type | Effet |
|---|---|---|
period | string | live (par défaut) — transactions à partir de 1 000 $, à partir de 100 $ pour un wallet smart ; today et 7d — takers à partir de 5 000 $ |
wallet | string | Transactions d’un seul wallet |
category | string | Catégorie du marché |
side | string | buy ou sell |
min_usd | number | Montant minimal de la transaction, $ |
insider | boolean | true — uniquement les transactions étiquetées insider |
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 et ask_now sont les prix actuels de l’issue : suivre cette transaction maintenant coûte 0,83, soit 1 ¢ de plus que ce qu’a payé le trader.
/predictions/traders donne le PnL sur toute la période, sur 30 et 7 jours (pnl_usd), roi_pct, won sur resolved et la courbe miniature pnl_series. Collez une adresse du classement dans le wallet du flux de transactions.
Comment l’utiliser
Vérifiez votre plan et les plateformes
/account/usageindique votre plan,/predictions/platforms— la fraîcheur des cotations.Demandez des lots avec des filtres
min_profit_pctetmax_dayssuppriment le bruit et les lots à longue échéance.Vérifiez les risques et les règles
Avec
rules_differ, lisez les règles de règlement des deux plateformes.Interrogez sans dépasser la fraîcheur de votre plan
Utilisez un intervalle d’au moins
meta.freshness_secet renvoyez l’ETagdansIf-None-Match: une réponse304ne consomme pas de quota.Tradez vous-même
Ouvrez le marché depuis
legs[].urlet vérifiez le prix dans son carnet d’ordres.
La même requête exact en 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("Endpoint or mode is not part of your API plan")
r.raise_for_status()
body = r.json()
ts = datetime.fromtimestamp(body["meta"]["updated_at"], timezone.utc)
print(f"Bundles: {body['meta']['count']}, data as of {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} d · {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(" risks:", ", ".join(b["risks"]))
Sur le site, ces mêmes lots sont présentés dans les guides Arbitrage prédictif et Mode Sport ; les API officielles des plateformes, dans les articles sur les API Polymarket et Kalshi et sur les cotes de paris via API.
Questions et réponses
Puis-je acheter des contrats ou placer des paris via Genesis API ?
Non. Genesis API ne fait que lire des données et ne passe aucun ordre : vous tradez et pariez vous-même sur les plateformes.
Pourquoi profit_usd vaut-il null pour une surebet ?
Au moins une jambe est un pari à cote, et la plateforme ne publie pas sa limite de mise. Le pourcentage de profit est connu ; calculez la somme de chaque jambe à partir de stake_unit.
L’API inclut-elle des surebets en direct ?
Non, uniquement l’avant-match. Pourquoi le direct est plus risqué : voir l’article sur l’avant-match et le direct.
Quel plan faut-il pour les surebets ?
Pro ou Max : avec Start, mode=sport renvoie 403 plan_restricted. Les tarifs figurent sur la page Tarifs de Genesis API.