← Tous les guides
Sur cette page
  1. Accueil
  2. Guides
  3. Comment interroger les EV de nœud GTO avec une API ?
Guide Stratégie GTO · 01/06 Applications de solveur 11 min Avancé

Comment interroger les EV de nœud GTO avec une API ?

Une fois qu’une situation résolue en temps réel par le solveur est terminée et que son arbre peut être interrogé, demandez les tableaux d’EV pour un nœud, éventuellement filtrés sur une main.

Mis à jour Maintenu par Pokerai API

Réponse directe : appelez POST /v1/gto/evs avec un identifiant solve provenant de /v1/gto/solver et un node_id provenant de /v1/gto/solver/tree. Le tableau actions de la réponse définit l’ordre du tableau d’EV de chaque main dans evs.

Faits rapides

Point de terminaisonPOST /v1/gto/evs
PrérequisUne résolution terminée et un arbre du solveur interrogeable ; vérifiez régulièrement /v1/gto/solver/tree en premier.
Entrée requisesolve et node_id ; hand filtre éventuellement une main.
Réponseactions et des tableaux evs par main. Chaque tableau d’EV est aligné par index sur actions.
QuotaLa description OpenAPI publique indique que cette lecture est gratuite après la résolution /v1/gto/solver d’origine.
AccèsUtilisez la même interface API authentifiée et les mêmes règles de propriété de l’identifiant du solveur que pour la résolution terminée.

Quand l’utiliser

Utilisez les EV de nœud dans des outils d’entraînement hors ligne, de coaching, de revue de mains, d’étude ou de recherche après qu’un résultat de solveur est disponible. Elles sont utiles lorsqu’une interface d’explication doit comparer les actions disponibles sur un nœud terminé sans planifier une autre résolution.

Quand ne pas l’utiliser

N’appelez pas ce point de terminaison avant que l’arbre du solveur soit interrogeable, et ne considérez pas un tableau d’EV comme une recommandation d’action en direct, une garantie de performance ou une définition de l’EV allant au-delà du contrat de réponse public.

Requête API minimale

Remplacez l’identifiant masqué par l’identifiant renvoyé par votre propre requête de solveur. Utilisez un identifiant de nœud de l’arbre du solveur correspondant. Le champ hand facultatif limite la réponse à cette main.

curl -s https://pokerai.bet/v1/gto/evs \
  -H "Authorization: Bearer $POKERAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"solve":"eyJ0Ijoic2x2X3h4eXoi...(handle from /v1/gto/solver)","node_id":"root","hand":"2c2d"}'

Interprétation de la réponse

{"node_id": "root", "task_id": "slv_srp_…", "player": 1, "round": "FLOP", "actions": ["CHECK", "BET 4.000000", "BET 97.000000"], "evs": {"2c2d": [-0.826359, -0.792223, -1.643411], "2c2h": […], …}}

Dans la forme de réponse publique des exemples de documentation, actions vaut [CHECK, BET 4.000000, BET 97.000000]. Pour evs["2c2d"], le premier nombre correspond à CHECK, le deuxième à BET 4.000000 et le troisième à BET 97.000000.

Conservez les deux tableaux ensemble dans une interface d’explication. Le contrat de l’API décrit ces valeurs comme des EV par main et par action en bb ; il ne sélectionne pas d’action et ne promet pas de résultat.

Quota et disponibilité

Ce point de terminaison est documenté comme gratuit, car la requête /v1/gto/solver à l’origine correspond au calcul facturé. Si le calcul n’a pas convergé, la réponse 200 peut être { spot_status: computing } ; continuez à interroger l’arbre du solveur jusqu’à ce qu’il soit interrogeable, au lieu de supposer que les données d’EV sont prêtes.

Erreurs

HTTPSignificationQue faire
400Données de requête non valides.Vérifiez solve, node_id et le champ facultatif hand par rapport au schéma public.
401L’authentification est absente ou non valide.Envoyez une clé API valide et ne l’exposez ni dans le code du navigateur ni dans les journaux.
403L’identifiant de résolution n’est pas valide ou ne vous appartient pas.Utilisez l’identifiant authentifié de votre propre requête au solveur.
410Le calcul a expiré (TTL).Reprogrammez le spot avec /v1/gto/solver.

Entraînement et revue 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 en argent réel est interdite. Gardez les comparaisons d’EV hors de l’automatisation des tables en direct et ne les transformez pas en invite d’action pendant une main.

Ressources associées