Genesis Arbitrage

Genesis Arbitrage · · 16 min de lecture

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=sport sur les plans Pro et Max, Genesis API renvoie des surebets avant-match sur 13 plateformes, avec un stake_unit pour chaque jambe. Leur profit_usd vaut 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.

NiveauCe qu'il contientExemple
ÉvénementSport, compétition, équipes, débutFootball, Bundesliga, Bayern — Dortmund
MarchéType de pari, période, ligneTotal 2.5, temps réglementaire
IssueSur quoi porte le pariPlus de 2.5
PrixCotes de chaque bookmakerFonbet @1.95, Winline @2.02
HeureQuand le prix a été mis à jouril 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.

PrixCote décimaleProbabilité
@2.25 chez un bookmaker2.2544,44 %
@3.60 chez un bookmaker3.6027,78 %
YES à 30¢ sur Polymarket1 / 0.30 = 3.3330 %

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.

IssueMeilleure coteOù1/k
1, victoire du Bayern@2.25Betcity0,44444
N, match nul@3.60Marathon0,27778
2, victoire de Dortmund@3.80Winline0,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.

PariMiseSi gagnant
Betcity · 1 @2.25451,04 $1 014,84 $
Marathon · N @3.60281,90 $1 014,84 $
Winline · 2 @3.80267,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érifierOù cela se passe malChamp dans mode=sport
Match et effectifBayern contre Bayern II, une équipe féminine ou de jeunesteams, flags
DébutUn bookmaker a reprogrammé le matchstarts_at
Type de marchéRésultat, handicap, total, BTTS, score exactmarket_type
PériodeTemps réglementaire ou match avec prolongationsperiod
LigneLes handicaps −1.5 et −1.25 sont des paris différentsline
Issues des jambesEnsemble, les jambes doivent couvrir toutes les issueslegs[].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 :

NiveauChampsDans l'exemple
Événementtitle, sport, league, teams, starts_atArsenal — Chelsea, soccer, Premier League
Marchémarket_type, period, line, scoreTOT, FT, 2.5
Jambeplatform, side, outcome, coversfonbet, bet, Under 2.5, U
Prixodds, price_avg, stake_unit, currency2.12, 0.471698, RUB
Résultatsize_usd, profit_pct, profit_usd1000, 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 $ :

JambeMiseSi gagnante
Polymarket · YES « Over 2.5 » à 50,5¢258,52 $511,92 parts — 511,92 $
Fonbet · Under 2.5 @2.12241,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 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.