← Tous les guides
Sur cette page
  1. Accueil
  2. Guides
  3. Comment calculer l’équité d’une range de poker avec une API ?
Guide Sémantique du poker · 08/09 Outils de range 11 min Intermédiaire

Comment calculer l’équité d’une range de poker avec une API ?

Envoyez la range de chaque joueur, un board facultatif et des paramètres Monte-Carlo reproductibles au point de terminaison d’équité PokerKit ; utilisez les parts renvoyées pour expliquer un scénario fourni, et non pour prédire un résultat.

Mis à jour Maintenu par Pokerai API

Réponse directe : appelez POST /v1/pokerkit/equity avec ranges contenant un tableau de notations par joueur. Incluez éventuellement un board, sample_count et seed. La réponse renvoie une équité Monte-Carlo par range fournie, ainsi que le nombre d'échantillons utilisé.

Informations clés

Point de terminaisonPOST /v1/pokerkit/equity
EntréeDeux ranges ou plus, une par joueur, en notation de ranges PokerKit ; board est facultatif.
MéthodeEstimation de l’équité par Monte-Carlo. Elle renvoie une estimation pour les ranges et le board fournis, et non une garantie de cotes.
Réponseresult.equities est ordonné pour correspondre à ranges ; result.sample_count indique le contexte d’échantillonnage.
QuotaCe point de terminaison consomme 1 quota de résolution. L’offre Free actuelle inclut 25 résolutions en temps réel par mois.
AccèsLes points de terminaison PokerKit et GTO utilisent la même clé API. Envoyez un en-tête de clé API pris en charge.

Sémantique des entrées

Utilisez un tableau de ranges imbriqué pour chaque joueur. L'ordre des tableaux est important, car les équités renvoyées suivent ce même ordre. Lorsqu'il est fourni, un board est une chaîne de cartes sans séparateur, telle que AhKhQh.

ChampSignification
rangesObligatoire. Tableaux, par joueur, de chaînes en notation de range, par exemple [["AA"], ["KK"]].
boardChaîne de cartes facultative pour le board connu ; omettez-la ou utilisez une chaîne vide lorsqu’aucun board n’est connu.
sample_countNombre d’échantillons Monte-Carlo facultatif. La limite de service documentée s’applique ; la valeur par défaut est utilisée lorsqu’il n’est pas défini.
seedGraine facultative pour un échantillonnage reproductible.

Requête API minimale

Cet exemple public de code de documentation compare AA et KK avant le board, avec un nombre d’échantillons et une seed fixes. Ajoutez votre clé API comme en-tête d’authentification lors de la requête HTTP.

{"ranges": [["AA"], ["KK"]], "board": "", "sample_count": 2000, "seed": 7}

Exemple de réponse et interprétation

{"result": {"equities": [0.8235, 0.1765], "sample_count": 2000}}

La première valeur, 0.8235, correspond à la première range d’entrée (AA) ; la seconde, 0.1765, correspond à KK. Conservez cet ordre dans votre interface utilisateur ou votre rapport.

Interprétez sample_count: 2000 comme le nombre d’échantillons de Monte-Carlo utilisés pour cette réponse. Il décrit le contexte d’échantillonnage de cette estimation ; ce n’est pas une promesse concernant une donne future, un pari ou les performances.

Quand l’utiliser

Utilisez le point de terminaison dans des produits de formation, des outils de revue de mains terminées, de coaching, de recherche ou une interface d’explication où les ranges et le board sont explicites pour l’utilisateur. Stockez les entrées fournies à côté du résultat afin que l’estimation reste vérifiable.

Quand ne pas l’utiliser

N’utilisez pas une estimation d’équité comme incitation à agir, en cours de main, avec de l’argent réel ; elle ne remplace ni le jugement du joueur, ni un modèle de jeu complet, ni une stratégie de solveur. Ne laissez pas entendre qu’une estimation garantit une victoire, une carte future ou l’issue des mises.

Quota et authentification

Envoyez Authorization: Bearer $POKERAI_API_KEY (ou l’équivalent X-API-Key) avec la requête. Le point de terminaison consomme 1 quota de résolution ; l’offre Free actuelle inclut 25 résolutions en temps réel par mois. Consultez l’utilisation actuelle dans le tableau de bord et lisez la rubrique sur les quotas avant de concevoir un traitement par lots.

Erreurs

HTTPSignificationQue faire
401missing_api_key ou invalid_api_key.Envoyez un en-tête de clé API valide et ne consignez pas la clé dans les journaux du client.
Quotaquota_exceeded lorsque le quota mensuel applicable est épuisé.Attendez la réinitialisation mensuelle ou ajustez la charge de travail ; n’effectuez pas de nouvelles tentatives pour des requêtes inchangées.
422La validation de la requête a échoué, par exemple en raison d’une forme de corps invalide.Consultez la référence actuelle ou le schéma OpenAPI et corrigez la saisie.

Entraînement et révision uniquement

Utilisez Pokerai API pour l’entraînement, le coaching, la revue de mains, l’étude et la recherche. L’assistance en temps réel aux tables d’argent réel est interdite. Gardez les affichages d’équité hors de l’automatisation des tables en direct et ne les transformez pas en recommandation d’action.

Ressources associées