API Polymarket et API Kalshi : prix, carnets d’ordres et arbitrage entre les deux
En bref
- Polymarket et Kalshi fournissent marchés, prix et carnets d’ordres via des API REST officielles sans clé. Une clé et une requête signée sont nécessaires pour passer des ordres, et chez Kalshi aussi pour ouvrir une connexion WebSocket.
- Le prix d’un contrat est une fraction de dollar : 0,42 signifie 42 ¢ et, selon le marché, une probabilité d’environ 42 %. Seul le carnet d’ordres montre combien coûtera un volume donné.
- L’arbitrage entre plateformes demande d’apparier les événements, de vérifier les règles et les dates de résolution, de parcourir les carnets d’ordres et de déduire les frais. Le endpoint
/predictions/arbitragede Genesis API renvoie des bundles avec tout cela déjà calculé ; les trades, vous les passez vous-même.
L’API Polymarket et l’API Kalshi sont les interfaces de programmation officielles de deux plateformes de marchés prédictifs : un programme y lit les marchés, les prix des contrats YES et NO et les carnets d’ordres, et, avec une clé et une requête signée, il passe des ordres. Les données de marché des deux plateformes se lisent sans clé. Pour l’arbitrage entre les deux, les prix ne suffisent pas : il faut apparier les événements et calculer le profit en parcourant les carnets d’ordres, frais compris. Les bundles prêts à l’emploi viennent du endpoint /predictions/arbitrage de Genesis API.
Comment sont structurées les données des marchés prédictifs
Un marché prédictif échange des contrats sur l’issue d’un événement. Chaque marché est une question à réponse oui ou non : un contrat YES paie 1 $ si l’événement se produit, et un contrat NO paie 1 $ s’il ne se produit pas. La façon dont les plateformes résolvent les marchés et la raison pour laquelle leurs prix divergent sont expliquées dans l’article Marchés prédictifs : comment fonctionnent Polymarket et Kalshi et dans la leçon Qu’est-ce que les marchés prédictifs. Voici à quoi ressemblent ces mêmes objets dans les API.
| Polymarket | Kalshi | |
|---|---|---|
| Groupe de marchés | Événement avec un ou plusieurs marchés | Série contenant des événements |
| Marché | Condition binaire avec issues Yes et No | Marché binaire avec un ticker |
| Issue dans l’API | Yes et No ont chacun un token ID | Côtés YES et NO d’un même marché |
| Prix | De 0,00 $ à 1,00 $ | Chaîne en dollars, p. ex. "0.4200" |
| Carnet d’ordres | Bids et asks pour chaque issue | Uniquement les bids YES et NO |
Un prix est une fraction de dollar : 0,42 correspond à 42 ¢ pour un contrat qui paie 1 $ si son issue se réalise. C’est pourquoi le prix se lit comme l’estimation de probabilité du marché, ici environ 42 %. Le site de Polymarket affiche le point médian entre le meilleur bid et le meilleur ask, ou le prix du dernier trade lorsque le spread dépasse 0,10 $ (documentation Polymarket). Pour chiffrer un trade, on utilise le carnet d’ordres.
Carnet d’ordres : bids, asks et prix miroirs
Un carnet d’ordres est la liste des ordres d’achat (bids) et de vente (asks) avec leurs prix et leurs tailles. Chez Polymarket, chaque issue a son propre carnet, demandé par token_id. Kalshi ne renvoie que des bids pour les deux côtés : un bid YES au prix X équivaut à un ask NO à 1,00 $ − X (documentation Kalshi).
Un exemple illustratif : le meilleur bid NO sur Kalshi est à 0,58. YES est donc offert à 1 − 0,58 = 0,42, soit 42 ¢.
API officielles de Polymarket et Kalshi
Polymarket
Les données de Polymarket viennent de trois API REST et de flux WebSocket (aperçu de l’API). Les données de marché, y compris les prix et carnets d’ordres du CLOB, ne demandent pas de clé.
| API | Ce qu’elle fournit |
|---|---|
| Gamma API | Événements et marchés : métadonnées, dates, identifiants des issues |
| CLOB API | Prix et carnets d’ordres ; avec des clés, les ordres |
| Data API | Positions et activité des portefeuilles, historique des prix |
| WebSocket | Canal de marché pour les carnets et les prix ; canal utilisateur pour les ordres et trades du compte |
Les ordres passent par une authentification CLOB en deux étapes : une signature du portefeuille (L1) délivre des identifiants CLOB (L2) qui signent les requêtes de trading. L’identifiant de l’issue pour le carnet vient de la Gamma API : les marchés v1 le portent dans la chaîne JSON clobTokenIds, les marchés v2 dans positionIds ; l’indice 0 est YES et 1 est NO (champs du marché). Au lieu de requêtes brutes, on peut utiliser le SDK Python officiel, le paquet polymarket-client.
Kalshi
Pour les marchés prédictifs, Kalshi propose une API REST (Trade API v2), WebSocket et FIX. L’hôte REST recommandé est external-api.kalshi.com ; l’ancien api.elections.kalshi.com fonctionne encore, et un environnement de démonstration distinct sert aux tests (environnements de l’API). Les séries, événements, marchés, carnets d’ordres et trades sont publics.
Une requête de trading est signée avec une clé privée (Ed25519 ou RSA) : l’identifiant de la clé, l’horodatage et la signature passent dans les en-têtes KALSHI-ACCESS-KEY, KALSHI-ACCESS-TIMESTAMP et KALSHI-ACCESS-SIGNATURE (clés API Kalshi). Les conditions du marché, dont les règles de résolution, arrivent sous forme de texte dans rules_primary et rules_secondary ; les meilleurs prix sont dans yes_bid_dollars, yes_ask_dollars, no_bid_dollars et no_ask_dollars.
Quand une clé est nécessaire
| Quoi | Polymarket | Kalshi |
|---|---|---|
| Marchés, prix, carnets (REST) | Sans clé | Sans clé |
| Flux des carnets (WebSocket) | Canal de marché, sans clé | Clé obligatoire, même pour les canaux publics |
| Ordres | Signature du portefeuille et identifiants CLOB | Requête signée avec une clé privée |
Lire un carnet d’ordres sans clé : curl et Python
# Polymarket: the book of one outcome by token_id
curl "https://clob.polymarket.com/book?token_id=$TOKEN_ID"
# Kalshi: the book of a market by ticker
K=https://external-api.kalshi.com/trade-api/v2
curl "$K/markets/$TICKER/orderbook"
Polymarket renvoie bids et asks, des niveaux avec price et size sous forme de chaînes, ainsi que tick_size et min_order_size. Kalshi renvoie un objet orderbook_fp avec les tableaux yes_dollars et no_dollars, où chaque niveau est une paire prix en dollars et nombre de contrats.
Ce que coûte un volume donné n’apparaît qu’en parcourant les niveaux. Cette fonction parcourt les asks de Polymarket à partir du meilleur et renvoie le meilleur prix, le prix moyen et le pire prix :
import requests
CLOB = "https://clob.polymarket.com"
def walk_asks(token_id: str, shares: float):
"""Best, average and worst price to buy `shares` shares.
The platform fee is not included here.
"""
r = requests.get(f"{CLOB}/book", params={"token_id": token_id},
timeout=10)
r.raise_for_status()
left, cost, prices = shares, 0.0, []
for level in reversed(r.json()["asks"]): # the best ask is last
price, size = float(level["price"]), float(level["size"])
take = min(left, size)
cost += take * price
prices.append(price)
left -= take
if left <= 1e-9:
return prices[0], round(cost / shares, 4), prices[-1]
return None # the book is too thin for the full size
print(walk_asks("TOKEN_ID_YES", 1000))
Le prix moyen est ici le VWAP de l’ordre : plus un achat s’enfonce dans le carnet, plus il s’éloigne du meilleur prix. Cet écart est le slippage, et le volume disponible près du meilleur prix est la profondeur de marché.
Pourquoi l’arbitrage Polymarket–Kalshi est difficile
L’arbitrage de prédiction entre plateformes consiste à acheter YES sur l’une et NO sur l’autre lorsque, ensemble, ils coûtent moins de 1 $ : si les deux résolvent de la même façon, une jambe paie 1 $ quoi qu’il arrive. Comparer deux prix via les API officielles est facile ; la paire ne devient un trade qu’après cinq vérifications.
| Vérification | Pourquoi c’est difficile |
|---|---|
| Appariement des événements | Les questions sont formulées différemment, et les identifiants et la structure diffèrent : un événement avec des marchés chez Polymarket, une série avec des événements chez Kalshi |
| Règles de résolution | La source, la formulation et les cas limites peuvent différer sous le même intitulé |
| Dates de résolution | Les marchés se clôturent à des dates différentes ; l’argent reste bloqué jusqu’à la date la plus tardive |
| Frais | Des formules différentes : chez Polymarket seuls les takers paient, chez Kalshi le type de frais est défini par série |
| Profondeur du carnet | Seul un nombre limité de contrats se vend au meilleur prix |
Chez Polymarket, seul le taker paie des frais, et leur montant dépend du prix de la part et de la catégorie du marché (frais Polymarket). Chez Kalshi, le type de frais et le multiplicateur sont portés par la série, dans les champs fee_type et fee_multiplier (séries dans l’API Kalshi). Il faut disposer de fonds sur les deux plateformes à l’avance, et l’accès à chacune dépend de votre pays et des règles de la plateforme.
Exemple chiffré : YES sur Polymarket, NO sur Kalshi
Un exemple illustratif : un marché « L’événement X se produit avant le 31 décembre » est coté sur les deux plateformes avec des règles identiques et se résout dans 46 jours. Vous voulez 1 000 parts de chaque côté.
| Jambe | Niveaux du carnet | Coût |
|---|---|---|
| YES sur Polymarket | 500 à 0,40 et 500 à 0,41 | 200 + 205 = 405 $ |
| NO sur Kalshi | 600 à 0,55 et 400 à 0,56 | 330 + 224 = 554 $ |
Les asks NO sur Kalshi viennent des bids YES : un bid YES de 0,45 pour 600 contrats est un ask NO à 0,55, et un bid de 0,44 pour 400 est un ask à 0,56.
Aux meilleurs prix, la paire coûte 0,40 + 0,55 = 0,95 : un avantage de 5 ¢ par part, soit 0,05 / 0,95 = 5,26 % sur l’argent engagé. Les prix moyens d’exécution à travers les carnets sont 0,405 et 0,554, soit 0,959 ensemble, si bien que l’avantage tombe à 4,1 ¢. Les frais de l’exemple sont de 6 $ chez Polymarket et 17 $ chez Kalshi, 23 $ au total.
Le profit est le paiement moins le coût des deux jambes et les frais, et le taux annuel (APR) découle du nombre de jours avant la résolution :
Dans l’exemple : 1 000 − 959 − 23 = 18 $ de profit, 18 / 982 × 100 = 1,83 % sur l’argent engagé, et 1,83 × 365 / 46 = 14,5 % par an. Sur les 5,26 % aux meilleurs prix, environ un tiers survit aux carnets et aux frais.
Si les deux plateformes résolvent de la même façon, une jambe paie 1 000 $ quoi qu’il arrive : 982 $ sortent et 18 $ de plus reviennent. Si les règles divergent et que les deux jambes perdent, la perte est de 982 $ en totalité.
Arbitrage de prédiction dans Genesis API
Le endpoint /predictions/arbitrage renvoie des bundles dont ce travail est déjà fait. Les marchés de Polymarket, Kalshi, Limitless, Predict.fun et Opinion sont appariés, chaque jambe est parcourue dans son carnet avec les frais, et l’on calcule le profit en $ et en %, l’APR et les jours avant la résolution. Ce sont les données de la page Arbitrage de prédictions, en JSON.
mode | Ce que vous obtenez | Plans de l’API |
|---|---|---|
exact | Événements exactement appariés sur deux plateformes, par défaut | Start, Pro, Max |
dutch | YES sur chaque issue d’un événement sur une plateforme | Start, Pro, Max |
llm | Paires d’événements vérifiées par IA | Pro, Max |
sport | Surebets sur 13 plateformes, avant-match uniquement | Pro, Max |
Le bundle de l’exemple ci-dessus ressemblerait à ceci dans une réponse, champs abrégés :
{
"kind": "cross",
"match": "exact",
"title": "Will event X happen by December 31?",
"days_left": 46,
"shares": 1000,
"size_usd": 959,
"fees_usd": 23,
"profit_usd": 18,
"profit_pct": 1.83,
"apr_pct": 14.5,
"risks": [],
"legs": [
{
"platform": "polymarket",
"side": "yes",
"price_best": 0.4,
"price_avg": 0.405,
"price_worst": 0.41,
"cost_usd": 405,
"fee_usd": 6
},
{
"platform": "kalshi",
"side": "no",
"price_best": 0.55,
"price_avg": 0.554,
"price_worst": 0.56,
"cost_usd": 554,
"fee_usd": 17
}
]
}
Dans une jambe, side indique quoi acheter : yes, no ou bet, une mise chez un bookmaker. price_best, price_avg et price_worst sont le meilleur prix, le prix moyen et le pire prix en parcourant le carnet ; cost_usd et fee_usd sont le coût et les frais de la jambe ; url renvoie au marché. apr_pct vaut null lorsque la résolution est à moins d’un jour.
Les codes de risks signalent ce que le calcul ne peut pas vérifier : rules_differ signifie que les règles de résolution des plateformes peuvent différer, end_mismatch que leurs dates de résolution diffèrent. En mode sport, un bundle avec une jambe chez un bookmaker a profit_usd = null, car la limite de mise est inconnue. Les surebets sont traitées dans l’article sur les API de cotes des bookmakers.
Filtrez les bundles avec min_profit_pct, min_profit_usd, min_apr, max_days, platform et category. Tous les filtres et champs figurent dans le guide Marchés prédictifs et surebets dans Genesis API. Sans code, les mêmes bundles se trouvent sur la page du service ; ses colonnes et ses tags sont expliqués dans le guide Arbitrage de prédictions.
État des plateformes, analytique et trades
| Endpoint | Ce qu’il renvoie | Plans de l’API |
|---|---|---|
/predictions/platforms | Mode du flux de la plateforme (ws, rest, down), heure des dernières cotations et du scan complet, nombre de marchés | Start, Pro, Max |
/predictions/analytics | Open interest et volume, variations de prix sur 1 h et 24 h, flux d’argent | Pro, Max |
/predictions/smart-money | Gros trades et baleines sur 24 h, schémas d’initiés, concentration des positions | Pro, Max |
/predictions/trades | Flux de trades de Polymarket : live à partir de 1 000 $ et trades des portefeuilles smart à partir de 100 $, today et 7d takers à partir de 5 000 $ | Pro, Max |
/predictions/traders | Top 300 des traders Polymarket par PnL sur 30 jours, 7 jours ou toute la période | Pro, Max |
Demandez /predictions/platforms en même temps que les bundles : si le flux d’une plateforme est down, ses prix dans les bundles peuvent être périmés. Chaque trade du flux porte des étiquettes de portefeuille (tags), l’indicateur insider, le rôle taker ou maker et les valeurs actuelles bid_now et ask_now de l’issue. L’étiquette insider décrit le comportement d’un portefeuille et ne prouve rien.
Sur Trial, ces endpoints renvoient 403 plan_restricted. Start coûte 50 $ par mois et actualise les données toutes les 30 s, Pro 100 $ et 10 s, Max 200 $ et 5 s. Comparez les plans sur les tarifs de Genesis API ; les mêmes écrans sur le site sont Analytique et Smart Money.
Python : bundles exact avec min_profit_pct et max_days
Toutes les meta.freshness_sec secondes, le script récupère les bundles exact avec au moins 1 % de profit qui se résolvent sous 60 jours. Il ignore les bundles dont une plateforme est en down et affiche les autres avec leurs prix de parcours du carnet. La clé vient de la variable d’environnement GENESIS_API_KEY ; la façon de l’obtenir est décrite 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": "exact", "min_profit_pct": 1, "max_days": 60}
def get(path, params=None):
while True:
r = requests.get(f"{API}{path}", headers=HEADERS,
params=params, timeout=10)
if r.status_code in (429, 503):
wait = int(r.headers.get("Retry-After", "5"))
if wait > 60: # the period quota is used up
raise SystemExit(f"Wait {wait} s: quota exhausted")
time.sleep(wait)
continue
r.raise_for_status() # 403: endpoint or mode not in your plan
return r.json()
while True:
feeds = get("/predictions/platforms")["data"]["platforms"]
down = {p["platform"] for p in feeds if p["mode"] == "down"}
body = get("/predictions/arbitrage", PARAMS)
for b in body["data"]:
if any(leg["platform"] in down for leg in b["legs"]):
continue # this platform's prices may be stale
print(f"{b['profit_pct']}% · ${b['profit_usd']} · "
f"APR {b['apr_pct']} · {b['days_left']} d · "
f"{b['title'][:40]}")
for leg in b["legs"]:
print(f" {leg['platform']} {leg['side']}: "
f"{leg['price_best']} / {leg['price_avg']} / "
f"{leg['price_worst']}, fee ${leg['fee_usd']}")
if b["risks"]:
print(" risks:", ", ".join(b["risks"]))
time.sleep(body["meta"]["freshness_sec"])
Chaque cycle fait deux appels. Sur Start, cela donne 2 × 86 400 / 30 = 5 760 appels par jour et 5 760 × 30 = 172 800 par période de 30 jours, pour un quota de 2 M. Une réponse filtrée n’a pas d’ETag ; l’économie vient donc de l’intervalle de polling : interroger plus vite que meta.freshness_sec n’apporte aucune donnée nouvelle. Plus de détails dans les guides Limites de Genesis API et réponses et erreurs.
Questions et réponses
Polymarket a-t-il une API officielle ?
Oui. La Gamma API fournit les événements et les marchés, la CLOB API les prix, les carnets d’ordres et les ordres, la Data API les positions, l’activité et l’historique des prix, et les mises à jour des carnets passent par WebSocket. Les données de marché ne demandent pas de clé ; les ordres exigent une signature du portefeuille et des identifiants CLOB. Voir la documentation Polymarket.
Faut-il une clé pour lire les marchés Kalshi ?
Pas pour REST : les séries, événements, marchés, carnets d’ordres et trades sont publics (démarrage rapide Kalshi). Une clé est requise pour les ordres et pour se connecter au WebSocket, même si l’on ne veut que des canaux publics.
Puis-je trader via Genesis API ?
Non. Genesis API ne fait que lire des données et ne passe aucun ordre. Vous ouvrez vous-même un bundle sur les plateformes grâce aux liens legs[].url. Le trading automatisé via les API officielles de Polymarket et Kalshi est en dehors de Genesis API et à vos propres risques.
À quelle fréquence les données sont-elles mises à jour ?
Genesis API sert un nouvel instantané toutes les meta.freshness_sec : 30 s sur Start, 10 s sur Pro et 5 s sur Max. La fraîcheur des cotations propres aux plateformes est indiquée par quotes_at et full_scan_at dans /predictions/platforms.
De quel plan Genesis API ai-je besoin pour l’arbitrage Polymarket–Kalshi ?
Start : il inclut les modes exact et dutch et l’état des plateformes. Les modes llm et sport, l’analytique, le smart money, les trades et le classement des traders sont sur Pro et Max.