← Todas las guías
En esta página
  1. Inicio
  2. Guías
  3. ¿Cómo obtengo la estrategia preflop desde una API?
Guía Estrategia GTO · 06/06 Herramientas de rangos 12 min Principiante

¿Cómo obtengo la estrategia preflop desde una API?

Llama a POST /v1/gto/preflop con las dos cartas de Hero, la posición de Hero y cada acción preflop anterior a Hero. Pokerai API determina la situación y devuelve una distribución de estrategia en JSON para esa mano.

Actualizado Mantenido por Pokerai API

Respuesta directa: autentícate con tu clave de API, envía hole_cards, positions.hero y la secuencia completa de preflop_actions, y selecciona opcionalmente preflop_version. Lee cada elemento de strategy como una frecuencia, no como un movimiento recomendado.

Datos clave

Punto de conexiónPOST /v1/gto/preflop
Entrada obligatoriahole_cards, positions.hero y preflop_actions
SalidaLa situation derivada, la strategy[] mixta y el uso actual de quota
CuotaCada llamada consume 1 consulta general prerresuelta; no utiliza la cuota de resolución en tiempo real
Uso previstoEntrenamiento, estudio, coaching, revisión de manos e investigación — nunca RTA con dinero real

Crear la solicitud preflop

La línea de acciones es explícita y ordenada. Comienza con las apuestas de ciegas, incluye cada retirada, igualada y subida antes de Hero, y detente antes de que actúe Hero. No incluyas a Hero en preflop_actions.

CampoQué enviar
hole_cardsExactamente dos cartas en una cadena sin separadores, como "AhKh".
positions.heroEl asiento de Hero en el conjunto actual de posiciones de 6-max: SB, BB, UTG, MP, CO o BTN.
preflop_actionsLa secuencia completa anterior a Hero. Cada elemento tiene position y action; las acciones distintas de fold incluyen el amount recién invertido en BB, no un total acumulado.
preflop_versionID opcional del conjunto de gráficos. Omítelo para usar el valor predeterminado de la plataforma o usa un ID devuelto por GET /v1/gto/preflop/versions.

Solicitud curl mínima

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

Lee la respuesta real

Esta respuesta capturada coincide con la solicitud anterior: Hero tiene AhKh en MP frente a una apertura de UTG. situation se deriva de la línea de acciones y quota informa del uso mensual de esta clave.

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

Cómo funciona la frecuencia mixta

Cada frequency es una probabilidad de 0 a 1, y las frecuencias de acción de la mano normalmente suman aproximadamente 1. Algunas manos son puras, como en la respuesta anterior; otras están genuinamente mezcladas.

Por ejemplo, una respuesta capturada para 9h9s en MP frente a una apertura UTG de 2.5BB devolvió retirarse 0.254, igualar 0.106 y subir 0.64. Eso significa un 25,4% de retirarse, un 10,6% de igualar y un 64% de subir. La API expone la distribución; no promete ni elige una acción recomendada.

Qué significa amount_bb

Para una subida devuelta, amount_bb es la cantidad absoluta a la que subir hasta en ciegas grandes. No es el amount incremental usado dentro del historial de acciones de la solicitud.

Subidas antes de HeroSituación derivadaamount_bb
0Apertura3
13-bet9
24-bet25
3 o más5-bet+100 con allin: true

Elige preflop_version de forma segura

El preflop_version opcional selecciona un conjunto de rangos preflop, y el mismo spot puede tener frecuencias diferentes entre versiones. El ejemplo usa 6max_RC_100bb_200NL; si se omite el campo, se selecciona el valor predeterminado de la plataforma.

Considera GET /v1/gto/preflop/versions como el endpoint de descubrimiento de referencia. Usa un ID que devuelva en lugar de suponer que los ID, profundidades de stack o formatos de hoy son permanentes.

Cuota y reintentos

Una consulta preflop consume 1 cuota general de soluciones preresueltas. Los campos quota.used y quota.limit de la respuesta muestran el contador mensual actual para esa clave API; el uso también es visible en el panel.

No vuelvas a intentar una solicitud con cuota agotada. Espera al restablecimiento mensual o cambia la cuota disponible; reserva la lógica de reintento para fallos transitorios documentados por la API.

Errores comunes

HTTPErrorCausa y solución
400invalid_hole_cardsEnvía exactamente dos cartas válidas en hole_cards.
400invalid_positions / invalid_actionsUsa una posición Hero documentada y una secuencia de acciones completa y legal que comience con las publicaciones de las ciegas.
400unsupported_preflop_versionActualiza GET /v1/gto/preflop/versions y utiliza uno de los ID devueltos.
401missing_api_key / invalid_api_keyEnvía una clave de API válida en el encabezado Authorization: Bearer.
404no_solutionLa situación solicitada no tiene datos preresueltos; verifica o cambia la situación en lugar de volver a intentarlo sin cambios.
429quota_exceededLa cuota general mensual se ha agotado; un reintento inmediato no ayudará.

Cuándo usar esto — y cuándo no

Usa las consultas de estrategia preflop en entrenadores, herramientas de estudio, flujos de trabajo de coaching, colas de revisión de manos, investigación y análisis de agentes sin conexión. Guarda las frecuencias devueltas junto con la versión y la situación de entrada para que una revisión siga siendo reproducible.

No uses Pokerai API para asistencia en tiempo real en mesas de dinero real y no conviertas una salida mixta en la afirmación de que un movimiento está garantizado o recomendado. La asistencia en tiempo real en mesas de dinero real está prohibida. Consulta los Términos.

No utilices Pokerai API para asistencia en tiempo real en mesas con dinero real, ni conviertas resultados mixtos en la afirmación de que un movimiento está garantizado o recomendado. La RTA con dinero real está prohibida por los Términos.

Referencia, SDK y próximos pasos