API Kalshi
Tradez et interrogez la première bourse de marchés de prédiction régulée par la CFTC. Contrats binaires oui/non sur des événements réels, prix entre 1 et 99 cents.
URL de base : https://external-api.kalshi.com/trade-api/v2
URL de démonstration : https://external-api.demo.kalshi.co/trade-api/v2
Obtenez votre clé API sur https://kalshi.com/account/api-keys (niveau Premier ou Market Maker requis)
Concepts clés
Hiérarchie : Séries > Événements > Marchés
- Séries — modèles d'événements récurrents (ex. "Rapport mensuel sur l'emploi", "Demandes hebdomadaires d'allocations chômage")
- Événements — instances spécifiques d'une série (ex. "Rapport sur l'emploi de mai 2026")
- Marchés — résultats binaires individuels au sein d'un événement (ex. "Les créations d'emplois seront-elles supérieures à 200 000 ?")
Tarification des contrats binaires
- Les prix sont en cents (1-99), représentant une probabilité implicite
- Un contrat Oui à 65c = le marché implique une probabilité de 65 %
- L'offre Oui au prix X équivaut à la demande Non à (100 - X) — les carnets d'ordres affichent uniquement les offres Oui et les offres Non
- Règlement : paie 1,00 $ (100 cents) si Oui, 0 $ si Non
- Toutes les valeurs monétaires (solde, prix, règlements) sont en cents
Format du ticker
- Série :
KXBTC,KXJOBLESS,KXINX - Événement :
KXBTC-25MAY30(série + date) - Marché :
KXBTC-25MAY30-T100000(événement + seuil/résultat)
Les tickers de matchs sportifs suivent un modèle différent : {SERIES}-{YYMONDD}{TEAM1}{TEAM2}-{TEAM}
- Exemple :
KXNHLGAME-25MAY12EDMORL-EDM(NHL, 12 mai 2025, Edmonton contre Orlando, Edmonton gagnant) - Chaque événement de match a deux marchés OUI mutuellement exclusifs — un par équipe
CRITIQUE : Navigation sur le marché basée sur les séries
N'UTILISEZ PAS /markets?keyword= pour les sports, les élections ou toute catégorie basée sur une série. Cela ne renvoie que des packs de paris multi-matchs, et non les marchés réels au niveau des matchs. La recherche de "NHL", "Fulham", "Premier League", etc. renvoie zéro résultat ou des résultats non pertinents.
Naviguez toujours : Série → Événements → Marchés. Les marchés au niveau des matchs se trouvent sous la hiérarchie série/événement et doivent être consultés via /events?series_ticker=KXXX. De plus, /markets/{ticker} peut retourner une erreur 404 pour les marchés de matchs. Les prix d'achat et de vente n'apparaissent que dans la réponse du point de terminaison de l'événement (/events/{event_ticker} avec with_nested_markets=true).
Ce modèle s'applique à toutes les catégories basées sur les séries, pas seulement aux sports :
- Matchs sportifs — NHL, NBA, NFL, MLB, EPL, etc.
- Courses politiques — marchés de candidats individuels au sein d'événements multi-candidats
- Marchés spécifiques à une entreprise — bénéfices, changements de PDG au sein d'une série
- Données économiques récurrentes — rapports sur l'emploi, demandes d'allocations chômage, CPI, etc.
Tickers de séries sportives connus :
| Sport | Ticker de série | Exemple |
|---|---|---|
| NHL | KXNHLGAME | KXNHLGAME-25MAY12EDMORL |
| NBA | KXNBAGAME | KXNBAGAME-25MAY12BOSLAL |
| NFL | KXNFLGAME | KXNFLGAME-25SEP07KCDET |
| MLB | KXMLBGAME | KXMLBGAME-25MAY12NYYLAD |
| EPL (Premier League) | KXEPLGAME | KXEPLGAME-25MAY12FULARS |
Flux de travail correct pour les sports :
# 1. Lister les matchs ouverts pour un sport
curl -s "https://external-api.kalshi.com/trade-api/v2/events?series_ticker=KXNHLGAME&status=open&with_nested_markets=true"
# 2. Obtenir un match spécifique avec l'offre/la demande en direct
curl -s "https://external-api.kalshi.com/trade-api/v2/events/KXNHLGAME-25MAY12EDMORL?with_nested_markets=true"
# FAUX — ne faites pas ceci :
# curl -s "https://external-api.kalshi.com/trade-api/v2/markets?keyword=NHL" ← renvoie des paris multiples, pas des matchs
Comment appeler
Kalshi utilise l'authentification par signature de paire de clés RSA. Trois en-têtes sont requis sur les requêtes authentifiées :
| En-tête | Valeur |
|---|---|
KALSHI-ACCESS-KEY | ID de la clé API ($KALSHI_ACCESS_KEY) |
KALSHI-ACCESS-SIGNATURE | Signature RSA-PSS de timestamp + méthode + chemin |
KALSHI-ACCESS-TIMESTAMP | Timestamp Unix (ms) |
Les points de terminaison GET publics (marchés, événements, carnets d'ordres) peuvent être appelés sans en-têtes d'authentification.
# Point de terminaison public — pas d'authentification requise
curl -s "https://external-api.kalshi.com/trade-api/v2/markets?limit=10&status=open"
Pour les points de terminaison authentifiés, utilisez la signature RSA-PSS directe (pas le SDK kalshi_python — il ne fonctionne pas) :
import os, time, base64, requests
from cryptography.hazmat.primitives import hashes, serialization
from cryptography.hazmat.primitives.asymmetric import padding
from cryptography.hazmat.backends import default_backend
from dotenv import load_dotenv
load_dotenv('/data/workspace/.env')
BASE_URL = "https://api.elections.kalshi.com"
def kalshi_headers(method: str, path: str) -> dict:
import re
raw = os.environ["KALSHI_PRIVATE_KEY"]
# Décode d'abord les séquences d'échappement littérales (certains canaux d'entrée
# enregistrent '\n' comme deux caractères barre oblique inverse + n au lieu d'un
# vrai saut de ligne).
raw = (raw.replace('\\r\\n', '\n').replace('\\n', '\n')
.replace('\\r', '\n').replace('\\t', ' '))
# Supprime les marqueurs PEM s'ils sont présents, puis supprime TOUS les espaces
# et réencapsule.
body = re.sub(r'-----BEGIN[^-]+-----', '', raw)
body = re.sub(r'-----END[^-]+-----', '', body)
body = re.sub(r'\s+', '', body)
wrapped = '\n'.join(body[i:i+64] for i in range(0, len(body), 64))
pem = f"-----BEGIN RSA PRIVATE KEY-----\n{wrapped}\n-----END RSA PRIVATE KEY-----\n"
private_key = serialization.load_pem_private_key(pem.encode(), password=None, backend=default_backend())
ts = str(int(time.time() * 1000))
msg = (ts + method + path).encode() # le chemin ne doit PAS inclure la chaîne de requête
sig = private_key.sign(msg, padding.PSS(mgf=padding.MGF1(hashes.SHA256()), salt_length=padding.PSS.DIGEST_LENGTH), hashes.SHA256())
return {
"KALSHI-ACCESS-KEY": os.environ["KALSHI_ACCESS_KEY"].strip(),
"KALSHI-ACCESS-TIMESTAMP": ts,
"KALSHI-ACCESS-SIGNATURE": base64.b64encode(sig).decode(),
"Content-Type": "application/json"
}
path = "/trade-api/v2/portfolio/balance"
resp = requests.get(BASE_URL + path, headers=kalshi_headers("GET", path))
print(resp.json()) # {"balance": 5000, ...} — le solde est en cents
Pièges de signature :
- PSS pas PKCS1v15 — Le remplissage PKCS1v15 renvoie 401. Doit utiliser PSS avec SHA256.
- Supprimez les chaînes de requête avant de signer — la signature est calculée sur le chemin nu uniquement (par exemple
/trade-api/v2/portfolio/balance), pas sur/trade-api/v2/portfolio/balance?param=valeur. L'inclusion de la chaîne de requête entraînera une erreur 401. - Format de la variable d'environnement pour la clé —
KALSHI_PRIVATE_KEYaccepte : le corps base64 brut, le PEM complet avec des sauts de ligne réels, ou le PEM complet avec des sauts de ligne réduits à des espaces blancs (courant lors du collage via des formulaires Web). Le helper normalise automatiquement tous les formats. Pour le stockage le plus robuste, enregistrez-le sous forme de PEM multi-lignes entre guillemets doubles avec des échappements\ndans.envpour que python-dotenv le réhydrate en une chaîne PEM réelle.
Spécification de l'API
Spécification OpenAPI complète : https://docs.kalshi.com/openapi.yaml
Routage des intentions
Faites correspondre l'intention de l'utilisateur au bon point de terminaison. Tous les chemins sont relatifs à l'URL de base.
Événements
| Méthode | Point de terminaison | Paramètres principaux | Description |
|---|---|---|---|
| GET | /events | limit (1-200), cursor, status, series_ticker, with_nested_markets | Lister les événements (exclut multivarié) |
| GET | /events/{event_ticker} | event_ticker, with_nested_markets | Obtenir un événement spécifique |
| GET | /events/{event_ticker}/metadata | event_ticker | Métadonnées de l'événement uniquement |
| GET | /events/multivariate | limit, cursor, series_ticker, collection_ticker, with_nested_markets | Lister les événements multivariés (combo) |
Marchés
| Méthode | Point de terminaison | Paramètres principaux | Description |
|---|---|---|---|
| GET | /markets | limit, cursor, status, ticker, event_ticker, series_ticker, min_close_ts, max_close_ts | Lister/filtrer les marchés |
| GET | /markets/{ticker} | ticker | Obtenir les détails d'un marché spécifique |
| GET | /markets/{ticker}/orderbook | ticker, depth | Carnet d'ordres actuel (offres oui + offres non) |
| GET | /markets/orderbooks | tickers (tableau, max 100) | Carnets d'ordres par lots |
| GET | /markets/trades | ticker, limit, cursor, min_ts, max_ts | Transactions sur les marchés |
Chandeliers
| Méthode | Point de terminaison | Paramètres principaux | Description |
|---|---|---|---|
| GET | /series/{series_ticker}/markets/{ticker}/candlesticks | series_ticker, ticker, start_ts, end_ts, period_interval | Chandeliers au niveau du marché |
| GET | /series/{series_ticker}/events/{ticker}/candlesticks | series_ticker, ticker, start_ts, end_ts, period_interval | Chandeliers agrégés au niveau de l'événement |
| GET | /markets/candlesticks | market_tickers, start_ts, end_ts, period_interval | Chandeliers par lots |
Valeurs period_interval : 1 (1 min), 60 (1 heure), 1440 (1 jour)
Prévisions et données en direct
| Méthode | Point de terminaison | Paramètres principaux | Description |
|---|---|---|---|
| GET | /series/{series_ticker}/events/{ticker}/forecast_percentile_history | percentiles (0-10000), start_ts, end_ts, period_interval | Historique des centiles de prévision |
| GET | /live_data/milestone/{milestone_id} | milestone_id, include_player_stats | Données d'étape en direct |
| GET | /live_data/batch | milestone_ids (tableau, max 100), include_player_stats | Données en direct par lots |
| GET | /live_data/game-stats/{milestone_id} | milestone_id | Statistiques play-by-play (football, basket-ball, football, hockey, baseball) |
Séries
| Méthode | Point de terminaison | Paramètres principaux | Description |
|---|---|---|---|
| GET | /series/{series_ticker} | series_ticker, include_volume | Obtenir le modèle de série |
| GET | /series | category, tags, include_volume, min_updated_ts | Lister toutes les séries |
Informations sur la bourse
| Méthode | Point de terminaison | Paramètres principaux | Description |
|---|---|---|---|
| GET | /exchange/status | — | Statut actuel de la bourse |
| GET | /exchange/schedule | — | Heures d'ouverture |
| GET | /exchange/announcements | — | Annonces de la plateforme |
| GET | /exchange/user_data_timestamp | — | Timestamp de synchronisation des données |
| GET | /series/fee_changes | series_ticker, show_historical | Historique des changements de frais |
Recherche et découverte
| Méthode | Point de terminaison | Paramètres principaux | Description |
|---|---|---|---|
| GET | /search/tags_by_categories | — | Tags organisés par catégories de séries |
| GET | /search/filters_by_sport | — | Filtres organisés par sport |
Ordres (Authentifié)
| Méthode | Point de terminaison | Paramètres principaux | Description |
|---|---|---|---|
| GET | /portfolio/orders | ticker, event_ticker, status, limit, cursor, subaccount | Lister les ordres de l'utilisateur |
| GET | /portfolio/orders/{order_id} | order_id | Obtenir un ordre spécifique |
| POST | /portfolio/orders | Corps : ticker, action, side, type, count, yes_price/no_price | Créer un ordre |
| DELETE | /portfolio/orders/{order_id} | order_id, subaccount | Annuler un ordre |
| POST | /portfolio/orders/{order_id}/amend | order_id, Corps : nouveau count/price | Modifier un ordre |
| POST | /portfolio/orders/{order_id}/decrease | order_id, Corps : montant de la réduction | Diminuer le nombre d'ordres |
| POST | /portfolio/orders/batched | Corps : tableau d'ordres | Création par lots (la taille max évolue avec le niveau) |
| DELETE | /portfolio/orders/batched | Corps : tableau d'IDs d'ordres | Annulation par lots |
| GET | /portfolio/orders/queue_positions | market_tickers, event_ticker, subaccount | Toutes les positions dans la file d'attente des ordres en cours |
| GET | /portfolio/orders/{order_id}/queue_position | order_id | Position dans la file d'attente d'un ordre spécifique |
Ordres V2 — Ordres Événement-Marché (Authentifié, Point Fixe)
| Méthode | Point de terminaison | Paramètres principaux | Description |
|---|---|---|---|
| POST | /portfolio/events/orders | Corps : ticker d'événement, côté du marché, prix (point fixe), count | Créer un ordre V2 |
| POST | /portfolio/events/orders/batched | Corps : tableau d'ordres V2 | Créer par lots V2 |
| DELETE | /portfolio/events/orders/{order_id} | order_id, subaccount | Annuler un ordre V2 |
| DELETE | /portfolio/events/orders/batched | Corps : tableau d'IDs d'ordres | Annuler par lots V2 |
| POST | /portfolio/events/orders/{order_id}/amend | order_id, Corps : nouveau count/price | Modifier un ordre V2 |
| POST | /portfolio/events/orders/{order_id}/decrease | order_id, Corps : nouveau nombre restant | Diminuer un ordre V2 |
Groupes d'ordres (Authentifié)
| Méthode | Point de terminaison | Paramètres principaux | Description |
|---|---|---|---|
| GET | /portfolio/order_groups | subaccount | Lister tous les groupes d'ordres |
| POST | /portfolio/order_groups/create | Corps : limite de contrats | Créer un groupe d'ordres |
| GET | /portfolio/order_groups/{id} | id, subaccount | Obtenir un groupe spécifique |
| DELETE | /portfolio/order_groups/{id} | id, subaccount | Supprimer le groupe et annuler tous les ordres |
| PUT | /portfolio/order_groups/{id}/limit | id, Corps : nouvelle limite | Mettre à jour la limite de contrats |
| PUT | /portfolio/order_groups/{id}/trigger | id, subaccount | Déclencher le groupe (annuler tous les ordres) |
| PUT | /portfolio/order_groups/{id}/reset | id, subaccount | Réinitialiser le compteur de contrats correspondant |
Portefeuille (Authentifié)
| Méthode | Point de terminaison | Paramètres principaux | Description |
|---|---|---|---|
| GET | /portfolio/balance | subaccount | Solde et valeur du portefeuille (en cents) |
| GET | /portfolio/positions | cursor, limit, count_filter, ticker, event_ticker, subaccount | Positions de l'utilisateur |
| GET | /portfolio/fills | ticker, order_id, min_ts, max_ts, limit, cursor, subaccount | Toutes les exécutions de transactions |
| GET | /portfolio/settlements | limit, cursor, ticker, event_ticker, min_ts, max_ts, subaccount | Historique des règlements |
| GET | /portfolio/deposits | limit, cursor | Historique des dépôts |
| GET | /portfolio/withdrawals | limit, cursor | Historique des retraits |
| GET | /portfolio/summary/total_resting_order_value | — | Valeur totale des ordres en cours (suite) |
...
[limité pour la traduction]