¿Cómo hago mi primera solicitud a la API de póker GTO?

Datos rápidos

Cuándo usar esta guía de inicio rápido

Úsalo para verificar la autenticación, inspeccionar la estructura de la respuesta o iniciar un entrenador, una herramienta de estudio, un flujo de trabajo de revisión de manos, un servicio backend o una integración de agente de IA.

Cuándo no usarlo

No uses este endpoint como consejo en vivo durante el juego con dinero real. Para un árbol personalizado de flop, turn o river, sigue el flujo de trabajo del solver en tiempo real en la documentación para desarrolladores en lugar de tratar esta consulta preflop como un solver postflop general.

Solicitud curl mínima

Crea una clave, guárdala localmente como POKERAI_API_KEY y ejecuta esta solicitud. Nunca incluyas la clave real en un commit ni la coloques en código del lado del cliente.

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 }
    ]
  }'

Respuesta real

Esta respuesta capturada es para MP con 9h9s tras una apertura UTG de 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 }
  ]
}

Las tres frecuencias suman 1: retirarse 25,4 %, igualar 10,6 % y subir a 9bb 64 %. Trata esto como una distribución para estudiar o de la que tomar muestras, no como una promesa de que una acción ganará.

Cuota

Pokerai API mide las consultas prerresueltas por separado de las resoluciones en tiempo real. Esta solicitud de preflop usa una consulta prerresuelta. El nivel Free incluye 1.000 consultas prerresueltas y 25 resoluciones en tiempo real al mes; ambos contadores se restablecen mensualmente y el uso actual se muestra en el panel de control. Consulta los precios para conocer los límites públicos actuales.

Errores comunes

El contrato público de OpenAPI para este endpoint declara estas respuestas sin éxito:

Opciones de SDK y MCP

Los clientes oficiales siguen el mismo contrato OpenAPI público y utilizan la misma clave de API y cuota. Los ejemplos completos con tipos están en la documentación del SDK.

• SDK de Python: pip install pokerai-bet (importar como pokerai).
• SDK de TypeScript / JavaScript: npm install @pokerai/client.
• Servidor MCP para agentes de IA: npx @pokerai/mcp. Las herramientas prerresueltas están activadas de forma predeterminada; activar las herramientas del solver consume la cuota de resoluciones independiente.

Sin RTA con dinero real