Comment traiter des ranges de poker avec une API ?
Utilisez les endpoints de range PokerKit pour transformer une notation documentée en combos concrets, examiner les propriétés déterministes d’une range ou estimer l’équité d’une range avec des contrôles Monte-Carlo explicites ; utilisez les endpoints de range GTO lorsque la tâche relève d’un workflow documenté utilisant des ranges issues d’un solveur.
POST /v1/pokerkit/range/expand pour développer la notation. Utilisez /range/value et /range/nut-advantage pour une analyse déterministe des ranges basée sur le board, et /range/equity-advantage lorsque vous avez besoin d'une estimation Monte-Carlo de la part d'équité. Pour les ranges issues d'un solveur, utilisez les contrats publiés /v1/gto/range, /v1/gto/flop/projected-range ou /v1/gto/turn/projected-range.En bref
| Notation | Tableaux de notation de ranges PokerKit tels que ["AA", "KQs"] ; expand renvoie des combinaisons concrètes de deux cartes. |
|---|---|
| Déterministe | range/expand, range/value et range/nut-advantage n'utilisent pas d'échantillonnage Monte-Carlo. |
| Monte-Carlo | range/equity-advantage accepte les paramètres documentés sample_count et seed ; une valeur d’initialisation permet un échantillonnage reproductible. |
| Quota | Les points de terminaison de range PokerKit déterministes consomment 1 quota général. range/equity-advantage consomme 1 quota de résolution. |
| Ranges GTO | Les points de terminaison de ranges GTO sont des workflows de solveur distincts. Consultez leur schéma actuel de requête et de réponse dans la Référence ou l’instantané OpenAPI. |
| Limite d’utilisation | Pour l'entraînement, le coaching, l'analyse de mains, l'étude et la recherche ; pas d'assistance en temps réel pour l'argent réel. |
Notation des ranges
Passez un tableau JSON de chaînes de notation. AA désigne une classe de mains à paire servie et KQs désigne roi-dame assortis ; la réponse d’expansion répertorie les paires de cartes concrètes. Conservez la notation, le board et l’ordre des joueurs avec votre saisie de revue enregistrée afin que le résultat reste interprétable.
Requête et réponse minimales vérifiées
Cet exemple public de code de documentation appelle POST /v1/pokerkit/range/expand. Envoyez votre clé API dans Authorization: Bearer $POKERAI_API_KEY et le type de contenu JSON.
{"notation": ["AA", "KQs"]}{"result": [["Ac", "Ad"], ["Ac", "Ah"], ["Ac", "As"], ["Ad", "Ah"], ["Ad", "As"], ["Ah", "As"], ["Kc", "Qc"], ["Kd", "Qd"], ["Kh", "Qh"], ["Ks", "Qs"]]}Chaque tableau interne correspond à une combinaison concrète de deux cartes. Cette réponse explique la notation fournie ; il ne s’agit pas d’une recommandation d’action GTO.
Choisir l’opération de range
| Besoin | Point de terminaison public | Méthode |
|---|---|---|
| Développer la notation | POST /v1/pokerkit/range/expand | Expansion déterministe des combinaisons. |
| Construire une range de value sur un board | POST /v1/pokerkit/range/value | Seuil déterministe de catégorie faite à l’aide de aggression ou de floor. |
| Comparer la part de nuts | POST /v1/pokerkit/range/nut-advantage | Répartition déterministe de la part de nuts par nombre de combinaisons. |
| Comparer la part d’équité | POST /v1/pokerkit/range/equity-advantage | Estimation Monte-Carlo pour deux ranges fournies ; utilisez sample_count et seed uniquement comme documenté. |
| Faire avancer une range du solveur | POST /v1/gto/range, /flop/projected-range, ou /turn/projected-range | Contrats de range GTO publiés pour le workflow du solveur indiqué. |
Déterministe ou Monte-Carlo
N’étiquetez pas un résultat expand, value ou nut-advantage comme une simulation : ces opérations sont déterministes pour la saisie fournie. equity-advantage est différent : il utilise Monte-Carlo, donc son résultat est une estimation pour les ranges et le board soumis. Un seed fixe rend l’échantillonnage reproductible, mais pas universellement exact ; conservez le sample_count renvoyé lors de la présentation du résultat.
Quotas et erreurs
| Signal | Signification | Que faire |
|---|---|---|
| 401 | missing_api_key ou invalid_api_key. | Envoyez un en-tête de clé API valide ; ne l’exposez pas dans les journaux client. |
| 429 | quota_exceeded lorsque le compteur mensuel applicable est épuisé. | Attendez la réinitialisation ou réduisez le travail ; n’effectuez pas de nouvelles tentatives pour une requête inchangée. |
| 422 | La validation de la requête a échoué. | Consultez la référence actuelle ou le schéma OpenAPI du point de terminaison et corrigez le corps. |
Consultez la documentation sur les quotas et le tableau de bord pour connaître les compteurs actuels. Les points de terminaison de range GTO suivent leur propre comportement de quota documenté.
Formation et revue uniquement
Ressources associées
- Documentation pour développeurs — authentification, PokerKit, workflows GTO et quotas.
- Référence API — schémas actuels des opérations de range.
- Instantané OpenAPI — contrat anglais lisible par machine.
- SDK Python, SDK TypeScript / JavaScript, et serveur MCP — points d’entrée officiels des packages.
- Guide de l’API d’équité au poker — estimations d’équité pour plusieurs ranges.
- llms.txt — point d’entrée concis pour LLM.