API REST · évaluation de mains · probabilités exactes
Cotes, équités et mains, calculées en un appel
evaluate() · odds() · outs()
Évaluez des mains, calculez l'équité d'un range face à un autre et estimez les cotes à chaque street. Le moteur de poker dont ont besoin vos trainers et vos apps.
curl -s https://api.pokerapi.fr/v1/evaluate \
-H "Authorization: Bearer $KEY" \
-d '{
"cards": ["A♠","K♠","Q♠","J♠","10♠"]
}'{ "rank": "royal_flush",
"rankClass": 1,
"label": "Quinte flush royale",
"probability": "0.000154%" }Quelle démarche pour intégrer une API sereinement ?
Projet, niveau, criticité : faites le point et obtenez votre checklist personnalisée des vérifications à mener.
Les 10 mains, par probabilité réelle
Probabilité de former chaque main à l’abattage (5 cartes parmi 52). Ce sont des faits de combinatoire, pas des prédictions de résultat.
Évaluateur de main interactif
Choisissez 5 cartes et obtenez instantanément le rang détecté, sa probabilité exacte parmi C(52,5) = 2 598 960 combinaisons, et la réponse JSON que retournerait POST /v1/evaluate. Validation en temps réel : doublons et main incomplète détectés.
Calculateur de cotes & d’outs
Estimez la probabilité d’améliorer votre main. Méthode : probabilité exacte (cartes inconnues) et « règle des 2 et 4 » (approximation reconnue). Un outil d’analyse, pas une promesse de gain.
Aucune issue n’est garantie : ces chiffres décrivent une distribution de cartes, pas le résultat d’une partie. Le poker en argent réel comporte un risque de perte.
Pot odds — Suivre ou se coucher ?
Croisez le pot, la mise à payer et vos outs pour savoir si l'appel est mathématiquement rentable. L'outil de décision fondamental du poker rationnel — ce que le endpoint /v1/outs alimente dans un bot d'entraînement.
Le calcul, étape par étape
Pot (150) ÷ Call (50) = 3.0 : 1. Le pot vous offre 3.0× votre mise.
Call ÷ (Pot + Call) = 50 ÷ 200 = 25.0%. Vous devez gagner ce pourcentage de fois pour rentabiliser l'appel sur le long terme.
Avec 9 outs (1 carte à venir), vous avez 19.6% de probabilité d'améliorer votre main.
19.6% < 25.0% → Appel non profitable à long terme. Se coucher est la décision EV+ ici.
/v1/outsDans un bot d'entraînement, ce calcul se pilote en temps réel : envoyez la main et le board, récupérez les outs, et alimentez automatiquement ce moteur de décision.
Ces cotes sont purement mathématiques. Elles supposent que votre tirage seul détermine le résultat et ne tiennent pas compte du fold equity, des raises, ni des erreurs adverses. Un edge positif ne garantit pas de gagner la main — le poker en argent réel comporte un risque de perte.
Outs des tirages courants
Le nombre de cartes qui améliorent votre main, pour les situations classiques.
Tirage couleur (flush draw)
13 cartes de la couleur − 4 déjà vues
Tirage quinte bilatérale
deux bouts ouverts, 4 + 4
Tirage quinte par le ventre
une seule valeur complète
Couleur + quinte combinés
tirage maximal classique
Paire → brelan (set)
les 2 cartes restantes de la valeur
Overcards (2 cartes hautes)
3 + 3 pour apparier
Endpoints de l’API
Une API REST simple, réponses JSON. Exemples illustratifs du format documenté.
/v1/evaluaterenvoie le rang d'une main de 5 à 7 cartes/v1/oddséquité à l'abattage par simulation Monte-Carlo/v1/outscompte les outs et la cote du tirage/v1/deck/shufflemélange vérifiable (seed Fisher-Yates)Le moteur de poker, en API
De l'évaluation de main au calcul d'équité, des maths exactes et rapides.
Évaluation de mains
Classez n'importe quelle main et comparez plusieurs combinaisons, du high card à la quinte flush royale.
Équité de ranges
Calculez l'équité d'un range contre un autre sur un board donné, par énumération ou Monte-Carlo.
Cotes & outs
Estimez cotes du pot, outs et probabilités d'amélioration à chaque street.
Questions fréquentes
Quelles variantes sont supportées ?
Texas Hold'em et Omaha, avec évaluation de mains, calcul d'équité range contre range et estimation des cotes à chaque street.
Le calcul d'équité est-il exact ?
Selon le cas, l'API énumère toutes les combinaisons restantes pour un résultat exact, ou utilise Monte-Carlo pour les situations très larges.
Puis-je l'utiliser dans un trainer ou un solveur ?
Oui, c'est l'usage visé : la rapidité du moteur permet d'alimenter trainers, quiz et outils d'analyse en temps réel.
Un projet poker à équiper ?
Trainer, solveur ou app : parlez-nous-en.