Genesis Arbitrage

Genesis Arbitrage · · 13 min de lecture

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

EndpointCe qu’il renvoiePlans API
/predictions/arbitrageLots d’arbitrage et surebetsStart, Pro, Max ; modes llm et sport — Pro, Max
/predictions/platformsÉtat des plateformesStart, Pro, Max
/predictions/analyticsKPI, variations de prix, flux d’argentPro, Max
/predictions/smart-moneyGrosses transactions, baleines, schémas d’initiésPro, Max
/predictions/tradesFlux des transactions PolymarketPro, Max
/predictions/tradersTop 300 des traders Polymarket par PnLPro, 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.

modeCe que vous obtenezkindPlans
exactLe même événement sur deux plateformes, valeur par défautcrossStart, Pro, Max
dutchUn ensemble d’issues d’un événement sur une plateformedutchStart, Pro, Max
llmPaires d’événements vérifiées par IAcrossPro, Max
sportSurebets sur des matchssportPro, 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ètreTypeEffet
modestringexact (par défaut), dutch, llm ou sport
categorystringCatégorie, comme dans le champ category
platformstringAu moins une jambe sur cette plateforme ; plusieurs, séparées par des virgules
min_profit_pctnumberProfit minimal, %
min_profit_usdnumberProfit minimal, $ ; les lignes avec profit_usd = null sont ignorées
min_aprnumberAPR minimal, %
max_daysnumberAu plus ce nombre de jours avant le règlement
sport, leaguestringSport 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"
    }
  ]
}
ChampSignification
id, first_seen, updated_atIdentifiant stable, date d’apparition et de mise à jour du lot
kind, matchcross, dutch ou sport ; match vaut exact, llm ou sport
title, categoryÉvénement ou marché et sa catégorie
ends_at, days_left, starts_atMoment du règlement, jours avant le règlement, début du match
size_usd, fees_usd, sharesTaille de la transaction et frais en $, nombre de parts
profit_usd, profit_pct, apr_pctProfit en $ et en %, APR ; apr_pct vaut null sous un jour
edge_cents, risksAvantage de prix en cents par part, codes de risque
legs[].platform, market, outcomePlateforme, marché et issue de la jambe
legs[].sideyes ou no — ce qu’il faut acheter ; bet — un pari à cote
legs[].price_best, price_avg, price_worstMeilleur prix, prix moyen et pire prix en parcourant le carnet
legs[].shares, cost_usd, fee_usd, urlParts, 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"
    }
  ]
}
ChampSignification
sport, league, teams, flagsSport, ligue, équipes, étiquettes du match
market_typeWIN — résultat, HCP — handicap, TOT — total, BTTS — les deux équipes marquent, CS — score exact
period, line, scorePériode de règlement, ligne de handicap ou de total, score pour CS
legs[].coversIssues couvertes par la jambe : O — plus de, U — moins de
legs[].oddsCote décimale ; null pour un achat YES ou NO
legs[].stake_unitPart de la mise : combien placer sur la jambe pour obtenir 1 $ en cas de gain, frais compris
legs[].currencyLa 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"
    }
  ]
}

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.

EndpointParamètresContenu
/predictions/analyticsaucunKPI, variations de prix sur 1 h et 24 h, flux d’argent, marchés bientôt réglés, nouveaux marchés
/predictions/smart-moneyaucunKPI, flux d’argent, insiders, concentration, smart_vs_price
/predictions/tradesperiod, wallet, category, side, min_usd, insiderTransactions Polymarket, les plus récentes d’abord
/predictions/tradersperiod : 30d (par défaut), 7d, allTop 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ètreTypeEffet
periodstringlive (par défaut) — transactions à partir de 1 000 $, à partir de 100 $ pour un wallet smart ; today et 7d — takers à partir de 5 000 $
walletstringTransactions d’un seul wallet
categorystringCatégorie du marché
sidestringbuy ou sell
min_usdnumberMontant minimal de la transaction, $
insiderbooleantrue — 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

  1. Vérifiez votre plan et les plateformes

    /account/usage indique votre plan, /predictions/platforms — la fraîcheur des cotations.

  2. Demandez des lots avec des filtres

    min_profit_pct et max_days suppriment le bruit et les lots à longue échéance.

  3. Vérifiez les risques et les règles

    Avec rules_differ, lisez les règles de règlement des deux plateformes.

  4. Interrogez sans dépasser la fraîcheur de votre plan

    Utilisez un intervalle d’au moins meta.freshness_sec et renvoyez l’ETag dans If-None-Match : une réponse 304 ne consomme pas de quota.

  5. Tradez vous-même

    Ouvrez le marché depuis legs[].url et 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.