← Tous les guides
Sur cette page
  1. Accueil
  2. Guides
  3. Comment obtenir une stratégie préflop depuis une API ?
Guide Stratégie GTO · 06/06 Outils de range 12 min Débutant

Comment obtenir une stratégie préflop depuis une API ?

Appelez POST /v1/gto/preflop avec les deux cartes du Héros, la position du Héros et chaque action préflop avant le Héros. Pokerai API détermine la situation et renvoie une distribution de stratégie JSON pour cette main.

Mis à jour Maintenu par Pokerai API

Réponse directe : authentifiez-vous avec votre clé API, envoyez hole_cards, positions.hero et la séquence complète preflop_actions, puis sélectionnez éventuellement preflop_version. Lisez chaque élément de strategy comme une fréquence, et non comme un coup recommandé.

Informations rapides

Point de terminaisonPOST /v1/gto/preflop
Entrée requisehole_cards, positions.hero et preflop_actions
RésultatLa situation dérivée, la strategy[] mixte et l’utilisation actuelle du quota
QuotaChaque appel facture 1 consultation générale présolue ; il n’utilise pas le quota de résolution en temps réel
Utilisation prévueEntraînement, étude, coaching, revue de mains et recherche — jamais de RTA en argent réel

Construire la requête préflop

La ligne d’action est explicite et ordonnée. Commencez par les mises de blindes, incluez chaque fold, call et relance avant le Héros, puis arrêtez-vous avant que le Héros agisse. N’incluez pas le Héros dans preflop_actions.

ChampÉléments à envoyer
hole_cardsExactement deux cartes sous la forme d’une seule chaîne non séparée, par exemple "AhKh".
positions.heroSiège du Héros dans l’ensemble actuel de positions 6-max : SB, BB, UTG, MP, CO ou BTN.
preflop_actionsLa séquence complète avant le Héros. Chaque élément comporte position et action ; les actions autres que fold incluent le amount nouvellement investi en BB, et non un total cumulé.
preflop_versionID facultatif de l’ensemble de grilles de stratégie. Omettez-le pour utiliser la valeur par défaut de la plateforme, ou utilisez un ID renvoyé par GET /v1/gto/preflop/versions.

Requête curl minimale

curl -s https://pokerai.bet/v1/gto/preflop \
  -H "Authorization: Bearer $POKERAI_API_KEY" -H "Content-Type: application/json" \
  -d '{"hole_cards":"AhKh","positions":{"hero":"MP"},"preflop_version":"6max_RC_100bb_200NL",
       "preflop_actions":[{"position":"SB","action":"small blind","amount":0.5},
                          {"position":"BB","action":"big blind","amount":1},
                          {"position":"UTG","action":"raise","amount":3}]}'

Lire la réponse réelle

Cette réponse capturée correspond à la requête ci-dessus : le Héros a AhKh en MP face à une ouverture UTG. situation est dérivé de la séquence d’actions, et quota indique l’utilisation mensuelle de cette clé.

{"hole_cards": "AhKh", "situation": "Raise", "strategy": [{"action": "raise", "frequency": 1, "amount_bb": 9, "sizing_pot": 0.8}], "quota": {"used": 7, "limit": 100}}

Fonctionnement des fréquences mixtes

Chaque frequency est une probabilité de 0 à 1, et les fréquences d’action pour la main totalisent normalement environ 1. Certaines mains sont pures, comme dans la réponse ci-dessus ; d’autres sont véritablement mixtes.

Par exemple, une réponse capturée pour 9h9s en MP face à une ouverture UTG de 2,5BB a renvoyé fold 0.254, call 0.106 et raise 0.64. Cela signifie 25,4 % de fold, 10,6 % de call et 64 % de raise. L’API expose la distribution ; elle ne garantit ni ne choisit une action recommandée.

Signification de amount_bb

Pour une relance renvoyée, amount_bb est le montant absolu jusqu’auquel relancer en grosses blindes. Ce n’est pas le amount incrémentiel utilisé dans l’historique des actions de la requête.

Relances avant le HérosSituation dérivéeamount_bb
0Ouverture3
13-bet9
24-bet25
3 ou plus5-bet+100 avec allin: true

Choisir preflop_version en toute sécurité

Le champ facultatif preflop_version sélectionne un ensemble de grilles de stratégie préflop, et une même situation peut avoir des fréquences différentes selon les versions. L’exemple utilise 6max_RC_100bb_200NL ; omettre ce champ sélectionne la valeur par défaut de la plateforme.

Considérez GET /v1/gto/preflop/versions comme le point de terminaison de découverte faisant autorité. Utilisez un ID qu'il renvoie plutôt que de supposer que les ID, profondeurs de tapis ou formats actuels sont permanents.

Quota et nouvelles tentatives

Une consultation préflop consomme 1 quota général précalculé. Les champs quota.used et quota.limit de la réponse indiquent le compteur mensuel actuel de cette clé API ; l’utilisation est également visible dans le tableau de bord.

Ne réessayez pas une requête dont le quota est épuisé. Attendez la réinitialisation mensuelle ou modifiez le quota disponible ; réservez la logique de nouvelle tentative aux échecs temporaires documentés par l’API.

Erreurs courantes

HTTPErreurCause et correctif
400invalid_hole_cardsEnvoyez exactement deux cartes valides dans hole_cards.
400invalid_positions / invalid_actionsUtilisez une position de Héros documentée et une séquence d’actions complète et légale qui commence par les mises de blindes.
400unsupported_preflop_versionActualisez GET /v1/gto/preflop/versions et transmettez l’un des identifiants renvoyés.
401missing_api_key / invalid_api_keyEnvoyez une clé API valide dans l’en-tête Authorization: Bearer.
404no_solutionLa situation demandée ne dispose d’aucune donnée précalculée ; vérifiez ou modifiez plutôt la situation au lieu de réessayer sans rien changer.
429quota_exceededLe quota général mensuel est épuisé ; une nouvelle tentative immédiate ne servira à rien.

Quand l’utiliser — et quand ne pas l’utiliser

Utilisez les consultations de stratégie préflop dans des entraîneurs, outils d’étude, flux de coaching, files d’examen des mains, travaux de recherche et analyses d’agents hors ligne. Stockez les fréquences renvoyées avec la version et la situation fournie afin qu’un examen reste reproductible.

N’utilisez pas Pokerai API pour une assistance en temps réel à des tables en argent réel, et ne présentez pas une sortie mixte comme la garantie ou la recommandation d’un seul coup. L’assistance en temps réel à des tables en argent réel est interdite. Consultez les Conditions.

N’utilisez pas l’API Pokerai pour une assistance en temps réel aux tables jouées avec de l’argent réel, et ne transformez pas une sortie mixte en affirmation qu’un coup est garanti ou recommandé. La RTA à des tables jouées avec de l’argent réel est interdite par les Conditions.

Référence, SDK et prochaines étapes