← Tous les guides
Sur cette page
Guide Stratégie GTO · 01/08 Applications de solveur 10 min Intermédiaire

Créer un produit d’analyse de poker en temps réel et à faible latence avec la Cache API de PokerAI

Affichez les fréquences d’action sitôt la stratégie reçue. Suivez une vraie main de 200NL dans un pot 3-bet, du catalogue à la river, puis récupérez l’EV et l’équité à la demande.

Mis à jour Maintenu par Pokerai API

Affichez la stratégie dès que /cache/query répond. Appelez /cache/ev ou /cache/eq à l’ouverture du panneau correspondant, pour que l’utilisateur puisse continuer à explorer la main pendant le chargement.

Quand utiliser la Cache API

Cette méthode permet d’afficher directement la stratégie des trois streets. Lorsqu’une situation a été entièrement précalculée, le flop, le turn et la river sont résolus ensemble dans un même arbre postflop. L’API lit les nœuds de cette solution au fil des cartes et des actions, ce qui préserve la cohérence de l’équilibre d’une street à l’autre. L’approximation de l’équilibre de Nash dépend des ranges, des tapis, des sizings de l’arbre et de la précision du solveur.

Les requêtes de stratégie et les appels séparés pour l’EV ou l’équité nécessitent Builder ou Pro. Toute clé API valide peut consulter gratuitement la couverture. Le cache couvre actuellement une partie des situations. Le catalogue liste les racines disponibles. La réponse de stratégie indique quelles suites d’actions ou cartes sont accessibles.

En bref : une main de 200NL dans un pot 3-bet

Cette main utilise le pack préflop 6max_RC_100bb_200NL. MP ouvre et SB 3-bet avec A♥K♥. Le flop est 4♣8♦9♥. Le pot contient 19 BB et il reste 91 BB de tapis effectif.

Ligne de mise sur trois streets
Street et cartesActionSuite
Flop4♣ 8♦ 9♥SB mise 13 BB
MP paie
Carte suivante A♠
TurnA♠SB mise 14 BB
MP paie
Carte suivante 7♦
River7♦SB mise 22 BB
MP paie
Abattage
Fig. 1. MP paie les trois mises jusqu’à l’abattage.

Nous suivons trois mises de 13, 14 et 22 BB, payées à chaque fois par MP. À la river, A♥K♥ checke le plus souvent. Dans cet exemple, on suit la mise de 22 BB jusqu’à l’abattage.

Trouver une situation couverte

Envoyez le pack préflop et le flop à /cache/coverage pour savoir quelles situations disposent déjà d’une stratégie enregistrée. Toute clé API valide peut interroger le catalogue sans entamer les quotas presolved, solve ou cache.

curl -G 'https://pokerai.bet/v1/gto/postflop/cache/coverage' \
  -H "Authorization: Bearer $POKERAI_API_KEY" \
  --data-urlencode 'preflop_pack=6max_RC_100bb_200NL' \
  --data-urlencode 'board=4c8d9h' \
  --data-urlencode 'limit=200'

preflop_pack et board sont obligatoires. Le catalogue a renvoyé l’entrée ci-dessous pour cette main. Capture d’origine incluant la réponse du catalogue.

{
  "preflop_pack": "6max_RC_100bb_200NL",
  "board": "4c8d9h",
  "pot_type": "3BET",
  "positions": {"raiser": "MP", "three_bettor": "SB", "hero": "SB"}
}

Lorsque l’utilisateur choisit « MP ouvre · SB 3-bet », reprenez ces champs pour demander le nœud racine. Pour changer de page, conservez le pack et le flop et transmettez next_cursor tel quel dans cursor. Même si items est vide, poursuivez lorsqu’un curseur est renvoyé. Arrêtez-vous à next_cursor: null. Si aucune entrée ne correspond, indiquez qu’aucune stratégie n’est enregistrée et laissez l’utilisateur décider s’il souhaite lancer une résolution.

Charger la stratégie du flop

Appelez /cache/query depuis votre serveur, où vous gardez la clé API. Indiquez hole_cards: "AhKh" pour lire la stratégie d’A♥K♥.

Ordre des appels à la Cache API
  1. 1. Trouver la situation/cache/coverageCatalogue gratuit
  2. 2. Charger et afficher la stratégie/cache/queryUne requête par racine et nouvelle carte. Actions ordinaires gratuites.
  3. 3. Charger les métriques à la demande/cache/ev ou /cache/eqUne requête par appel admis
Fig. 2. Trouvez la situation, affichez la stratégie et demandez l’EV ou l’EQ à l’ouverture du panneau.

L’ouverture du nœud racine consomme une requête de cache.

POST /v1/gto/postflop/cache/query
{
  "preflop_pack": "6max_RC_100bb_200NL",
  "board": "4c8d9h",
  "pot_type": "3BET",
  "positions": {"hero": "SB", "raiser": "MP", "three_bettor": "SB"},
  "hole_cards": "AhKh"
}

Affichez les fréquences de strategy et gardez le token reçu. Le champ node: "root" de la réponse peut servir de libellé dans votre interface. Pour poursuivre, placez le jeton du nœud voulu dans node. Si la matrice de toute la range est déjà chargée, changez de main en affichant la ligne correspondante. Relancez une lecture lorsque le nœud d’action ou le tableau change.

Suivre l’action jusqu’à la river

Avec A♥K♥, SB mise 13 BB au flop environ 69,02 % du temps. MP paie et l’A♠ tombe. SB mise 14 BB 77,65 % du temps. Après un nouveau call et l’arrivée du 7♦, SB checke 88,63 % du temps. Nous suivons ici la mise de 22 BB (10,20 %) et le call.

Fréquences d’action d’A♥K♥
Flop 4♣ 8♦ 9♥
  • Check 23,53 %
  • Mise 6 BB 7,45 %
  • Mise 13 BB 69,02 %
  • Tapis 0,00 %
Turn A♠
  • Check 1,96 %
  • Mise 14 BB 77,65 %
  • Mise 31 BB 20,39 %
  • Tapis 0,00 %
River 7♦
  • Check 88,63 %
  • Mise 22 BB 10,20 %
  • Tapis 1,18 %
Fig. 3. Les fréquences suivent la ligne décrite. Les pourcentages sont normalisés et arrondis. Les captures contiennent les valeurs exactes.

Pour avancer après une mise ou un call, transmettez le jeton du nœud enfant correspondant dans node. À un nœud chance, transmettez son jeton avec turn_card ou river_card. La fonction query de l’exemple appelle /cache/query. Exemple Node.js complet avec authentification et gestion des erreurs.

const opponent = await query("flop-bet", {
  node: cachedAction(flop, "bet", 13),
});
const chance = await query("flop-call", {
  node: cachedAction(opponent, "call"),
});
const turn = await query("turn-deal", {
  node: chance.token,
  turn_card: "As",
  hole_cards: "AhKh",
});

Les lectures après une mise ou un call sont gratuites avec un jeton valide. Chaque nouvelle carte de turn ou de river consomme une requête de cache. Conservez le chemin des actions pour permettre à l’utilisateur de revenir à un nœud déjà consulté.

Charger l’EV et l’équité à la demande

/cache/ev renvoie les valeurs attendues des actions et /cache/eq l’équité de la main. Chaque endpoint reçoit le jeton du nœud action courant et une main précise. Le jeton détermine le pack, le tableau et les ranges.

const hand = { node: flop.token, hole_cards: "AhKh" };

const ev = await http("flop-ev", "/v1/gto/postflop/cache/ev", hand);
const actionValues = ev.ev.status === "ok" ? ev.ev.action_values : null;

const eq = await http("flop-eq", "/v1/gto/postflop/cache/eq", hand);
const equityPercent = eq.eq.status === "ok" ? eq.eq.value * 100 : null;

/cache/query renvoie la stratégie. Les anciens paramètres include_ev:true et include_eq:true renvoient HTTP 400, sans consommer de quota ni lancer de calcul. Omettez-les ou laissez-les à false dans les anciens clients.

L’EV correspond au gain net attendu en BB en suivant la stratégie enregistrée. L’EQ utilise le tableau courant et la range adverse du nœud racine du flop enregistré, qui reste fixe le long de la ligne.

Nœud et actions précédentes EV d’A♥K♥ EQ
Flop 4♣8♦9♥ (première mesure) −6,4512 BB 44,5677 %
Turn A♠ (mise de 13 BB, payée) 18,8904 BB 83,2143 %
River 7♦ (puis mise de 14 BB, payée) 5,3115 BB 73,4660 % (nouvelle vérification)

Pour comparer les actions d’un même nœud, utilisez action_values dans la réponse EV. Réponses des métriques mesurées.

Temps de réponse et quota

Lors de la même série de mesures au flop, la stratégie est arrivée en 4,425 s, l’EV en 14,184 s et l’EQ en 8,566 s. Lors de la vérification à la river, la stratégie est arrivée en 1,319 s après le choix de la carte et la requête EQ a pris 6,827 s. Affichez d’abord les fréquences, puis chargez chaque métrique à l’ouverture de son panneau.

Temps de réponse par street Ligne en 200NL · échelle commune en secondes
RequêteDuréeSérie
Flop4♣ 8♦ 9♥
Stratégie · racine4,425 sA
EV14,184 sA
EQ8,566 sA
TurnA♠
Stratégie · carte1,348 sB
EV6,983 sB
EQ6,482 sB
River7♦
Stratégie · carte1,319 sC
EV6,519 sB
EQ6,827 sC
Même lettre, même série · 18 nov., heure de Hong Kong A Racine du flop, 13:37–13:38 B Ligne de mise, 17:44–17:45 C Vérification EQ, 20:52
Fig. 4. De l’envoi HTTPS public à la lecture complète de la réponse. L’EV et l’EQ à la river proviennent de séries différentes. Consulter les relevés de mesure。

Chaque barre représente une requête HTTPS publique réussie, mesurée jusqu’à la lecture complète de la réponse. Les durées varient selon le nœud et l’état du service.

Opération API Requêtes de cache consommées
Parcourir le catalogue avec /cache/coverage 0
Ouvrir un nœud racine avec /cache/query 1
Suivre une action avec un jeton valide 0
Choisir une nouvelle carte de turn ou de river avec /cache/query 1 par requête
Envoyer une requête EV ou EQ admise 1 par requête

Les trois streets de stratégie consomment trois requêtes de cache. Avec l’EV et l’EQ à chaque street, le total est de neuf. La vérification à la river en a utilisé quatre, dont une pour l’EQ. La lecture du call au turn a pris 1,317 s et n’a rien consommé.

Les erreurs de saisie, les jetons expirés et les autres refus avant admission ne consomment rien. Une erreur peut survenir après le débit. Consultez cache_quota si ce champ est présent et évitez les relances automatiques. Un nouvel envoi constitue une nouvelle requête.

Exécuter l’exemple complet

Conservez ensemble les positions, la main, le tableau et les actions. Donnez à l’EV et à l’EQ des états de chargement et d’erreur distincts, pour continuer à afficher la stratégie si une métrique est indisponible.

Télécharger l’exemple Node.js. Il trouve la situation, suit les trois mises payées jusqu’à l’abattage, puis lit l’EV et l’EQ de chaque street. Avec une seule page de catalogue et aucune erreur, cela représente 16 requêtes et neuf unités de quota cache.

En production, utilisez une clé Builder ou Pro. L’exécution consomme le quota de ce compte. Le script s’arrête à la première erreur et conserve ses résultats déjà affichés.

export POKERAI_API_KEY='YOUR_SERVER_API_KEY'
node reproduce.mjs

Mesures en production et citation

Ces données datent du 18 novembre 2026. La capture initiale compte 13 réponses réussies et une erreur HTTP 503 sur l’EQ à la river. Les huit requêtes de vérification ont ensuite réussi sur la même ligne, avec de nouveaux jetons. Le nœud racine du flop, chaque nouvelle carte et l’EQ à la river ont consommé une requête chacun.

Pour citer ces mesures, indiquez le pack, le tableau, le chemin des actions, la date et la méthode de chronométrage. Il s’agit de requêtes individuelles observées. Cette intégration est destinée à l’entraînement, à la recherche et à la revue après la session. L’assistance en temps réel aux tables en argent réel est interdite.

Documentation API · Référence API · OpenAPI · llms.txt

Si la situation n’est pas dans le cache, si vous utilisez Free ou Starter, ou si vous voulez changer les ranges ou les sizings des streets suivantes, affichez d’abord le flop précalculé puis résolvez la suite à la demande.

Créer une analyse de poker à faible latence avec des données précalculées et le solveur en temps réel. Le guide complémentaire reprend la même main de 200NL dans un pot 3-bet pour montrer comment transmettre les deux ranges et afficher la stratégie du turn puis de la river.