← Todas las guías
En esta página
  1. Inicio
  2. Guías
  3. ¿Cómo consulto los EV de nodos GTO con una API?
Guía Estrategia GTO · 01/06 Aplicaciones de solucionador 11 min Avanzado

¿Cómo consulto los EV de nodos GTO con una API?

Después de que se complete una situación del solver en tiempo real y se pueda consultar su árbol, solicita las matrices de EV de un nodo, opcionalmente filtradas para una mano.

Actualizado Mantenido por Pokerai API

Respuesta directa: llama a POST /v1/gto/evs con un identificador solve de /v1/gto/solver y un node_id de /v1/gto/solver/tree. La matriz actions de la respuesta define el orden de la matriz de EV de cada mano en evs.

Datos rápidos

Punto de conexiónPOST /v1/gto/evs
Requisito previoUna resolución completada y un árbol del solver consultable; consulta primero /v1/gto/solver/tree.
Entrada requeridasolve y node_id; hand filtra opcionalmente a una mano.
RespuestaArrays actions y evs por mano. Cada array de EV se alinea por índice con actions.
CuotaLa descripción pública de OpenAPI indica que esta lectura es gratuita después de la resolución /v1/gto/solver de origen.
AccesoUsa la misma superficie de API autenticada y las reglas de propiedad del identificador del solver que en la resolución completada.

Cuándo usar esto

Usa los EV de nodo en herramientas de entrenamiento sin conexión, coaching, revisión de manos, estudio o investigación después de que esté disponible un resultado del solver. Son útiles cuando una interfaz de explicación necesita comparar las acciones disponibles en un nodo completado sin programar otra resolución.

Cuándo no usarlo

No llame a este punto de conexión antes de que el árbol del solver se pueda consultar, y no trate una matriz de EV como una recomendación de acción en vivo, una garantía de rendimiento ni una definición de EV más allá del contrato de respuesta público.

Solicitud de API mínima

Sustituya el identificador oculto por el identificador devuelto por su propia solicitud al solver. Use un identificador de nodo del árbol del solver correspondiente. El campo opcional hand limita la respuesta a esa mano.

curl -s https://pokerai.bet/v1/gto/evs \
  -H "Authorization: Bearer $POKERAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"solve":"eyJ0Ijoic2x2X3h4eXoi...(handle from /v1/gto/solver)","node_id":"root","hand":"2c2d"}'

Interpretación de la respuesta

{"node_id": "root", "task_id": "slv_srp_…", "player": 1, "round": "FLOP", "actions": ["CHECK", "BET 4.000000", "BET 97.000000"], "evs": {"2c2d": [-0.826359, -0.792223, -1.643411], "2c2h": […], …}}

En la estructura de respuesta de código de la documentación pública, actions es [CHECK, BET 4.000000, BET 97.000000]. Para evs["2c2d"], el primer número se corresponde con CHECK, el segundo con BET 4.000000 y el tercero con BET 97.000000.

Mantén ambos arrays juntos en una interfaz de explicación. El contrato de la API describe estos valores como EV por mano y por acción en bb; no selecciona una acción ni promete un resultado.

Cupo y disponibilidad

Este endpoint se documenta como gratuito porque la solicitud de origen /v1/gto/solver es la resolución con cargo. Si la resolución no ha convergido, la respuesta 200 puede ser { spot_status: computing }; siga consultando el árbol del solver hasta que se pueda consultar, en lugar de asumir que los datos de EV están listos.

Errores

HTTPSignificadoQué hacer
400Datos de solicitud no válidos.Comprueba solve, node_id y el parámetro opcional hand con el esquema público.
401Falta autenticación o no es válida.Envíe una clave API válida y manténgala fuera del código del navegador y de los registros.
403El identificador de la solución no es válido o no te pertenece.Usa el identificador autenticado de tu propia solicitud al solver.
410La resolución expiró (TTL).Vuelva a programar la situación con /v1/gto/solver.

Solo para entrenamiento y revisión

Usa Pokerai API para entrenamiento, coaching, revisión de manos, estudio e investigación. Se prohíbe la asistencia en tiempo real en mesas con dinero real. Mantén las comparaciones de EV fuera de la automatización de mesas en vivo y no las conviertas en una indicación de acción durante la mano.

Recursos relacionados