Comment effectuer ma première requête à l’API GTO de poker ?

Créez une clé API Pokerai gratuite, envoyez une requête JSON authentifiée à POST /v1/gto/preflop, puis interprétez les fréquences d’action renvoyées comme une stratégie mixte.

Mis à jour 26 juillet 2026Maintenu par Pokerai API

Réponse directe : Placez votre clé dans l’en-tête Authorization: Bearer <API_KEY> et envoyez le spot complet au format JSON. La réponse indique la fréquence de chaque action disponible ; elle ne choisit pas un coup recommandé.

Informations clés

Point de terminaison	`POST /v1/gto/preflop`
Authentification	Clé API Bearer depuis la connexion au tableau de bord
Entrée	Cartes fermées, position du Héros et séquence complète des actions préflop
Sortie	Fréquences de se coucher, de suivre ou de relancer, avec les tailles de relance lorsqu’elles sont présentes
Quota	Une recherche pré-résolue pour cette requête ; le forfait Free inclut 1 000 recherches pré-résolues par mois
Utilisation autorisée	Formation, coaching, analyse de mains, étude et recherche ; pas de RTA en argent réel

Quand utiliser ce guide de démarrage rapide

Utilisez-le pour vérifier l’authentification, examiner la structure de la réponse ou démarrer un entraîneur, un outil d’étude, un flux de révision des mains, un service backend ou une intégration d’agent IA.

Quand ne pas l’utiliser

N’utilisez pas ce point de terminaison comme conseil en direct pendant une partie en argent réel. Pour un arbre de décision personnalisé au flop, au turn ou à la river, suivez le flux de travail du solveur en temps réel dans la documentation pour développeurs au lieu de considérer cette recherche préflop comme un solveur postflop général.

Requête curl minimale

Créez une clé, stockez-la localement sous POKERAI_API_KEY, puis exécutez cette requête. Ne validez jamais la véritable clé dans un commit et ne la placez jamais dans du code côté client.

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

Réponse réelle

Cette réponse capturée concerne MP avec 9h9s après une ouverture UTG à 2.5bb :

{
  "hole_cards": "9h9s",
  "situation": "Raise",
  "strategy": [
    { "action": "fold", "frequency": 0.254 },
    { "action": "call", "frequency": 0.106 },
    { "action": "raise", "frequency": 0.64, "amount_bb": 9, "sizing_pot": 1 }
  ]
}

Les trois fréquences totalisent 1 : se coucher 25,4 %, suivre 10,6 % et relancer à 9bb 64 %. Considérez cela comme une distribution à étudier ou à échantillonner, et non comme la promesse qu’une action l’emportera.

Quota

L’API Pokerai comptabilise séparément les recherches présolues et les résolutions en temps réel. Cette requête préflop utilise une recherche présolue. L’offre gratuite comprend 1 000 recherches présolues et 25 résolutions en temps réel par mois ; les deux compteurs sont réinitialisés chaque mois et l’utilisation actuelle est affichée dans le tableau de bord. Consultez les tarifs pour connaître les limites publiques actuelles.

Erreurs courantes

Le contrat OpenAPI public de ce point de terminaison déclare les réponses non réussies suivantes :

HTTP	Signification	Que faire
`400`	JSON non valide, champ manquant, cartes, position ou séquence d’actions non valides.	Corrigez la requête ; ne réessayez pas sans modification.
`401`	`missing_api_key` ou `invalid_api_key`.	Vérifiez l’en-tête Bearer et la clé.
`429`	`quota_exceeded` : le quota mensuel de recherches présolues est épuisé.	Attendez la réinitialisation mensuelle ou modifiez le quota du compte.

Options SDK et MCP

Les clients officiels suivent le même contrat OpenAPI public et utilisent la même clé API et le même quota. Des exemples typés complets se trouvent dans la documentation SDK.

SDK Python : pip install pokerai-bet (à importer sous le nom de pokerai).
SDK TypeScript / JavaScript : npm install @pokerai/client.
Serveur MCP pour les agents d’IA : npx @pokerai/mcp. Les outils pré-résolus sont activés par défaut ; activer les outils du solveur consomme le quota de résolutions distinct.

Pas de RTA en argent réel

Utilisez Pokerai API uniquement pour l’entraînement, le coaching, la révision des mains, l’étude et la recherche. L’assistance en temps réel aux tables en argent réel est interdite. L’API renvoie des fréquences de stratégie que votre application doit interpréter ; elle ne garantit pas de gains et ne sélectionne pas d’action pour le jeu en direct.

Étape suivante

Une fois que la requête curl a réussi, choisissez la ressource qui correspond à ce que vous créez :

Créer un entraîneur GTO — transformez la première requête en un petit flux d’entraînement exécutable
Référence API interactive — inspectez le schéma de requête et de réponse pour chaque point de terminaison
Documentation développeur — continuez avec les arbres de flop, les résolutions en temps réel, les quotas, les SDK et MCP