API de paris sportifs pour l'arbitrage : événements, cotes et surebets par API
En bref
- Une API de paris sportifs renvoie des événements, des marchés et les cotes de chaque bookmaker avec l'heure de la dernière mise à jour. La probabilité implicite d'une cote décimale vaut 1/k, et le prix d'un contrat YES sur un marché de prédiction est cette même probabilité en dollars.
- Un surebet existe quand la somme des 1/k des meilleures cotes de toutes les issues d'un marché est inférieure à 1, et chaque mise est proportionnelle à 1/k. La plupart des erreurs viennent de l'appariement : le match, le marché, la période et la ligne doivent être identiques sur chaque plateforme.
- Avec
mode=sportsur les plans Pro et Max, Genesis API renvoie des surebets avant-match sur 13 plateformes, avec unstake_unitpour chaque jambe. Leurprofit_usdvaut null, car la limite de mise du bookmaker est inconnue.
Une API de paris sportifs, ou API de cotes, donne à un programme accès à la ligne : événements, marchés et cotes de chaque bookmaker, avec l'heure de la dernière mise à jour de chaque prix. À partir de ces données, un programme compare les prix entre plateformes et trouve des surebets — des paris sur toutes les issues d'un match qui se terminent en profit quel que soit le résultat, à condition que tous les paris soient acceptés et réglés selon les mêmes règles. C'est l'arbitrage de paris, et Genesis API fournit des surebets prêts à l'emploi sur 13 plateformes via l'endpoint /predictions/arbitrage avec mode=sport.
Ce que renvoie une API de paris sportifs
Chaque fournisseur nomme ses champs à sa façon, mais une API de cotes décrit la ligne sur cinq niveaux. Sans la période et la ligne, deux cotes ne sont pas comparables, et sans l'heure on ne sait pas si un prix est encore valable. La colonne de droite est un exemple illustratif.
| Niveau | Ce qu'il contient | Exemple |
|---|---|---|
| Événement | Sport, compétition, équipes, début | Football, Bundesliga, Bayern — Dortmund |
| Marché | Type de pari, période, ligne | Total 2.5, temps réglementaire |
| Issue | Sur quoi porte le pari | Plus de 2.5 |
| Prix | Cotes de chaque bookmaker | Fonbet @1.95, Winline @2.02 |
| Heure | Quand le prix a été mis à jour | il y a 12 secondes |
Les cotes arrivent en format décimal, fractionnaire ou américain, et les plateformes de prédiction cotent le prix d'un contrat en dollars au lieu de cotes. Les données viennent soit de l'API ouverte d'une plateforme, soit d'un fournisseur qui réunit les lignes de nombreux bookmakers dans un format unique. Les données de Polymarket et Kalshi sont traitées dans l'article sur les API de Polymarket et Kalshi.
Cotes, probabilité et prix en cents
Les cotes décimales indiquent combien revient pour chaque dollar misé, mise comprise : 100 $ à @2.25 deviennent 225 $. L'inverse est la probabilité implicite : 1 / 2.25 = 0,4444, soit 44,44 %. Les cotes fractionnaires et américaines se convertissent en cotes décimales avec les formules de Les cotes de paris expliquées.
| Prix | Cote décimale | Probabilité |
|---|---|---|
| @2.25 chez un bookmaker | 2.25 | 44,44 % |
| @3.60 chez un bookmaker | 3.60 | 27,78 % |
| YES à 30¢ sur Polymarket | 1 / 0.30 = 3.33 | 30 % |
Un contrat YES paie 1 $ si son issue se réalise, son prix en dollars est donc l'estimation de probabilité du marché. Un contrat NO sur « victoire du Bayern » gagne si Dortmund gagne ou si le match est nul, comme la double chance.
Chez un seul bookmaker, les probabilités de toutes les issues d'un marché totalisent plus de 1, et l'excédent est sa marge. Exemple illustratif : la ligne de Fonbet sur Bayern — Dortmund, 2.15 / 3.45 / 3.40, donne 0,46512 + 0,28986 + 0,29412 = 1,04910, soit une marge de 4,91 %. Le calcul pas à pas est dans Comment calculer la marge d'un bookmaker.
Comment trouver un surebet à partir des cotes
Un surebet se trouve avec les meilleurs prix entre bookmakers : pour chaque issue du marché, on prend la cote la plus haute et on additionne les 1/k. Exemple illustratif : le même match, le marché du résultat sur le temps réglementaire.
| Issue | Meilleure cote | Où | 1/k |
|---|---|---|---|
| 1, victoire du Bayern | @2.25 | Betcity | 0,44444 |
| N, match nul | @3.60 | Marathon | 0,27778 |
| 2, victoire de Dortmund | @3.80 | Winline | 0,26316 |
L = 0.44444 + 0.27778 + 0.26316 = 0.98538
La somme est inférieure à 1 : il y a donc un surebet, avec un profit de 1 / 0.98538 − 1 = 1.48%. Les lignes propres aux quatre bookmakers dans le code ci-dessous portent des marges de 3,8 % à 5,1 % ; le surebet vient de l'écart entre leurs évaluations du match.
La mise totale se répartit proportionnellement aux 1/k : sur 1 000 $, la victoire à domicile reçoit 1 000 × 0,44444 / 0,98538 = 451,04 $, et les autres mises sont dans le tableau.
| Pari | Mise | Si gagnant |
|---|---|---|
| Betcity · 1 @2.25 | 451,04 $ | 1 014,84 $ |
| Marathon · N @3.60 | 281,90 $ | 1 014,84 $ |
| Winline · 2 @3.80 | 267,06 $ | 1 014,83 $ |
Chaque issue rapporte environ 1 000 / 0,98538 = 1 014,84 $ ; le profit dans le pire cas est de 14,83 $ à cause de l'arrondi des mises.
La même logique en code, avec en entrée la ligne d'un marché chez quatre bookmakers :
# Illustrative example: one 1X2 market line at four sportsbooks
line = {
"Fonbet": {"1": 2.15, "X": 3.45, "2": 3.40},
"Betcity": {"1": 2.25, "X": 3.20, "2": 3.40},
"Marathon": {"1": 2.05, "X": 3.60, "2": 3.50},
"Winline": {"1": 2.10, "X": 3.35, "2": 3.80},
}
def surebet(line, bank):
outcomes = next(iter(line.values())).keys()
# best odds for each outcome and the sportsbook offering them
best = {o: max((odds[o], bk) for bk, odds in line.items())
for o in outcomes}
total = sum(1 / k for k, _ in best.values())
if total >= 1:
return None # no surebet
for o, (k, bk) in best.items():
print(f"{o}: {bk} @{k} — ${bank / k / total:.2f}")
return round((1 / total - 1) * 100, 2)
print(surebet(line, 1000), "%") # 1.48 %
Un marché à deux issues — handicap, totaux, les deux équipes marquent — a deux clés dans le dictionnaire, et la formule reste la même. L'arrondi des mises et le recalcul après un mouvement des cotes sont traités dans la leçon Comment calculer un surebet.
Appariement : un match, un marché, une période et une ligne
La formule ne tient que si chaque prix appartient au même marché du même match. Les bookmakers écrivent les noms d'équipes différemment, les heures de début diffèrent de quelques minutes et les marchés ont leurs propres noms. Une erreur d'appariement produit un faux surebet : les 1/k totalisent moins de 1, mais sur l'une des issues tous les paris perdent.
| Ce qu'il faut vérifier | Où cela se passe mal | Champ dans mode=sport |
|---|---|---|
| Match et effectif | Bayern contre Bayern II, une équipe féminine ou de jeunes | teams, flags |
| Début | Un bookmaker a reprogrammé le match | starts_at |
| Type de marché | Résultat, handicap, total, BTTS, score exact | market_type |
| Période | Temps réglementaire ou match avec prolongations | period |
| Ligne | Les handicaps −1.5 et −1.25 sont des paris différents | line |
| Issues des jambes | Ensemble, les jambes doivent couvrir toutes les issues | legs[].covers |
Le temps réglementaire au football, c'est 90 minutes plus les arrêts de jeu. Les plateformes de paris y règlent généralement le résultat du match, les handicaps et les totaux au football et au hockey, sauf si le nom du marché précise que les prolongations et les tirs au but sont inclus. Un marché du vainqueur sur une plateforme de prédiction peut inclure les prolongations, et un nul au temps réglementaire peut alors faire perdre toute la paire.
Un handicap forme un surebet avec le handicap opposé de même taille : domicile −1.5 et extérieur +1.5. Sur un handicap asiatique en quart comme −0.75, la mise se répartit par moitiés sur les deux lignes voisines, et domicile −0.75 avec extérieur +0.75 couvre aussi tous les scores. Les totaux se couplent sur une même ligne : plus de 2.5 avec moins de 2.5.
La paire inverse, plus de 2.5 et moins de 3.5, est un middle : avec trois buts, les deux paris gagnent. Dans Genesis API, line et period sont fixés une seule fois pour tout le surebet, si bien que des jambes de lignes différentes ne se retrouvent jamais dans une même ligne.
Surebets via Genesis API : mode=sport
L'endpoint /predictions/arbitrage avec mode=sport renvoie des surebets où ce travail est déjà fait : les événements sont appariés entre plateformes, les meilleurs prix sont choisis et les jambes des plateformes de prédiction sont parcourues dans le carnet d'ordres avec les frais. 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 qu'un match commence, son surebet disparaît de la réponse.
Le mode fait partie des plans Pro (100 $ par mois, un nouveau snapshot toutes les 10 s) et Max (200 $, toutes les 5 s) ; sur Trial et Start, la requête renvoie 403 plan_restricted. L'API ne renvoie pas la ligne complète de chaque bookmaker : la réponse ne contient que les surebets trouvés, avec la plateforme, l'issue et le prix de chaque jambe.
curl -G "https://api.genesisarbitrage.com/v1/predictions/arbitrage" \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX" \
-d mode=sport -d sport=soccer -d min_profit_pct=1.5
Exemple illustratif : une ligne mode=sport de la documentation avec des prix recalculés :
{
"id": "s:8812:FT: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"
},
{
"platform": "fonbet",
"side": "bet",
"outcome": "Under 2.5",
"covers": ["U"],
"odds": 2.12,
"stake_unit": 0.471698,
"currency": "RUB"
}
]
}
Les cinq niveaux de la ligne correspondent aux champs de la ligne de réponse :
| Niveau | Champs | Dans l'exemple |
|---|---|---|
| Événement | title, sport, league, teams, starts_at | Arsenal — Chelsea, soccer, Premier League |
| Marché | market_type, period, line, score | TOT, FT, 2.5 |
| Jambe | platform, side, outcome, covers | fonbet, bet, Under 2.5, U |
| Prix | odds, price_avg, stake_unit, currency | 2.12, 0.471698, RUB |
| Résultat | size_usd, profit_pct, profit_usd | 1000, 2.39, null |
market_type est le marché : WIN — résultat du match, HCP — handicap, TOT — total, BTTS — les deux équipes marquent, CS — score exact, avec le score dans score. side vaut yes ou no pour l'achat d'un contrat et bet pour un pari à cote. covers liste les issues qu'une jambe couvre : ici O est plus et U est moins.
Comment répartir la mise avec stake_unit
stake_unit est la somme à placer sur une jambe pour qu'elle rapporte 1 $ si elle gagne. Pour un pari à cote, c'est 1 / odds : 1 / 2.12 = 0,471698. Pour l'achat de YES ou NO, c'est le prix moyen du carnet d'ordres frais compris ; l'exemple illustratif n'a pas de frais, donc stake_unit est égal à price_avg.
Les unités totalisent 0,505 + 0,471698 = 0,976698, donc le profit est de 1 / 0.976698 − 1 = 2.39%. Répartissez votre propre montant S avec la formule du surebet : mise de la jambe = S × stake_unit / Σ stake_unit. Pour 500 $ :
| Jambe | Mise | Si gagnante |
|---|---|---|
| Polymarket · YES « Over 2.5 » à 50,5¢ | 258,52 $ | 511,92 parts — 511,92 $ |
| Fonbet · Under 2.5 @2.12 | 241,48 $ | 511,94 $ |
Chaque issue rapporte environ 511,93 $, soit un profit dans le pire cas de 11,92 $. size_usd est ce que les carnets d'ordres des plateformes de prédiction absorbent à ces prix. Ici, c'est 1 000 $ : 1 000 / 0,505 ≈ 1 980,2 parts, donc le pari chez Fonbet pourrait aller jusqu'à 1 980,2 × 0,471698 ≈ 934,06 $ si le bookmaker l'accepte.
profit_usd vaut null parce que le profit en dollars dépend de ce que Fonbet accepte, et le bookmaker ne publie pas sa limite de mise. C'est pourquoi le filtre min_profit_usd écarte tout surebet comportant une jambe chez un bookmaker : filtrez-les plutôt par min_profit_pct.
Le pari chez Fonbet est en roubles (currency = RUB). À un taux illustratif de 80 ₽ pour 1 $, cela fait 241,48 × 80 = 19 318,40 ₽, et moins de 2.5 rapporte 19 318,40 × 2.12 = 40 955,01 ₽. L'écart de taux de change à la conversion n'est pas inclus dans profit_pct.
Python : surebets football avec min_profit_pct
Le script demande les surebets football avec un profit de 1,5 % ou plus, affiche chacun avec le temps restant avant le coup d'envoi et répartit le montant BANK entre les jambes selon stake_unit. La clé vient de la variable d'environnement GENESIS_API_KEY ; la façon d'en obtenir une est dans le démarrage rapide.
import os
import time
import requests
API = "https://api.genesisarbitrage.com/v1"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}
PARAMS = {"mode": "sport", "sport": "soccer", "min_profit_pct": 1.5}
BANK = 500 # total stake for the whole surebet, $
def fetch():
while True:
r = requests.get(f"{API}/predictions/arbitrage",
headers=HEADERS, params=PARAMS, timeout=10)
if r.status_code in (429, 503):
time.sleep(int(r.headers.get("Retry-After", "5")))
continue
if r.status_code == 403:
raise SystemExit("mode=sport needs the Pro or Max plan")
r.raise_for_status()
return r.json()["data"]
def unit(leg): # $1 of winnings: stake_unit, else 1/odds or price
if leg.get("stake_unit"):
return leg["stake_unit"]
return 1 / leg["odds"] if leg.get("odds") else leg["price_avg"]
for row in fetch():
mkt = [row["market_type"], row["line"], row["period"]]
mkt = " ".join(str(v) for v in mkt if v is not None)
hours = (row["starts_at"] - time.time()) / 3600
print(f"{row['profit_pct']}% · {row['title']} · {mkt} · "
f"starts in {hours:.1f} h")
total = sum(unit(leg) for leg in row["legs"])
for leg in row["legs"]:
price = leg.get("odds") or leg.get("price_avg")
print(f" {leg['platform']}: {leg['outcome']} at {price} — "
f"${BANK * unit(leg) / total:.2f} ({leg['currency']})")
Le montant de chaque jambe est affiché en dollars à côté de la devise de la plateforme : convertissez un pari en roubles à votre propre taux. Si une jambe n'a pas de stake_unit, unit se rabat sur 1 / odds ou price_avg sans les frais, si bien que le profit ressort un peu plus élevé qu'il ne l'est réellement.
Pour suivre les nouveaux surebets, répétez la requête toutes les meta.freshness_sec et comparez les valeurs de id : chaque surebet garde son id. Une réponse filtrée arrive sans ETag, vous économisez donc le quota par l'intervalle : une requête toutes les 10 s sur Pro, c'est 86 400 / 10 = 8 640 appels par jour et 8 640 × 30 = 259 200 sur 30 jours, face à un quota de 5M, voir les limites de Genesis API. Les filtres league, platform (par exemple fonbet) et max_days sont décrits dans le guide des endpoints des marchés de prédiction.
Les risques que l'API ne peut pas vérifier
L'API évalue un surebet à partir d'un snapshot, alors que vous placez les paris vous-même sur deux ou trois plateformes, et chacune peut fausser le calcul.
- Les cotes bougent. Quelques secondes ou minutes passent entre le snapshot et votre pari : le bookmaker baisse la cote, ou les ordres peu chers du carnet sont exécutés.
- Limites et limitation des mises. Un bookmaker peut accepter moins que demandé ou limiter le compte ; les raisons sont dans Pourquoi les bookmakers limitent les arbitrageurs. Placez d'abord le pari à cote, puis achetez YES ou NO pour le montant accepté.
- Annulation. Si un match est annulé ou reporté, le bookmaker rembourse généralement le pari à la cote 1, tandis que le marché YES/NO se règle selon ses propres règles, et le surebet peut finir en perte.
- Devise. La conversion entre roubles et dollars n'est pas incluse dans le profit de la ligne.
- Erreur manifeste. Une cote très supérieure à celles des autres bookmakers peut être une erreur, et le bookmaker peut régler le pari à nouveau.
Les paris sont réglementés différemment selon les pays : vérifiez les lois locales et les règles de chaque plateforme. L'ordre de travail et tous les risques sont réunis dans la leçon Risques des surebets et règles de travail, et le fonctionnement de la recherche est expliqué dans Scanner de surebets.
Les colonnes, les filtres et les étiquettes sont décrits dans le guide du mode Sport.
Questions et réponses
Existe-t-il une API de paris sportifs gratuite ?
Cela dépend du fournisseur : les quotas de requêtes et la liste des bookmakers et des marchés varient, et l'accès gratuit, quand il existe, est limité en volume. Polymarket et Kalshi servent des données de marché via leurs API officielles sans clé (Polymarket, Kalshi), mais ce sont des prix de contrats YES et NO, sans cotes de bookmakers. Genesis API n'a pas de plan gratuit : mode=sport est inclus dans Pro (100 $ par mois) et Max (200 $) ; comparez les plans sur les tarifs de Genesis API.
L'API a-t-elle des cotes en direct ?
Pas dans Genesis API : le mode sport ne cherche que des surebets avant-match, et un surebet quitte la réponse dès que le match commence. Pourquoi les arbitrages en direct échouent plus souvent est expliqué dans Arbitrage avant-match et en direct.
Pourquoi profit_usd vaut-il null pour un surebet ?
Au moins une jambe est un pari chez un bookmaker, et le bookmaker ne publie pas la limite de mise de votre compte. Le pourcentage profit_pct est connu ; calculez le montant de chaque jambe à partir de stake_unit.
Puis-je placer des paris via Genesis API ?
Non. Genesis API ne fait que lire des données : les paris et les achats, vous les faites vous-même sur les plateformes, avec les liens de legs[].url.