¿Cómo ejecuto un flujo de trabajo del solver GTO?
Crea una resolución personalizada de flop, turn o river, consulta su árbol hasta que se pueda consultar y, después, solicita la estrategia de un nodo completado.
POST /v1/gto/solver, conserva el identificador solve devuelto, consulta POST /v1/gto/solver/tree hasta que spot_status sea queryable y, a continuación, pasa el token de un nodo devuelto a POST /v1/gto/solver/node.Datos rápidos
| Dato | Valor |
|---|---|
| Crear | POST /v1/gto/solver programa una resolución de flop, turn o river; la longitud del board selecciona la calle. |
| Disponibilidad | Consulta POST /v1/gto/solver/tree hasta que spot_status sea queryable. |
| Leer | Pasa un token de nodo del árbol a POST /v1/gto/solver/node. |
| Cuota | Una resolución nueva usa una cuota de resolución; la reutilización en caché y las lecturas de árbol y nodo no consumen cuota de resolución. |
| Plan gratuito | 1.000 consultas preresueltas + 25 resoluciones en tiempo real al mes. |
Cuándo usarlo
Usa este flujo de trabajo para una situación personalizada de flop, turn o river cuando necesites enviar el board, los rangos, el bote, el stack efectivo y la posición de Hero. Es el ciclo de vida de un identificador de resolución enviado, no una afirmación sobre todos los formatos de póker ni la calidad de los resultados.
Cuándo no usarlo
No lo uses para asistencia en tiempo real con dinero real (RTA): Pokerai API es para entrenamiento, coaching, revisión de manos, estudio e investigación. No trates una respuesta computing, expired, no_nodes o error de nodo como una estrategia completada.
Solicitud mínima verificable
curl -s https://pokerai.bet/v1/gto/solver -H "Authorization: Bearer $POKERAI_API_KEY" -H "Content-Type: application/json" -d '{"board":"2c2h2s","oop_range":"AA,KK","ip_range":"QQ,JJ","pot":6,"effective_stack":100,"hero":"OOP"}'Almacena el identificador solve de la respuesta. Una respuesta puede indicar computing o queryable; solo un desencadenante nuevo incluye solve_quota.
Consulta el árbol y después lee un nodo completado
curl -s https://pokerai.bet/v1/gto/solver/tree -H "Authorization: Bearer $POKERAI_API_KEY" -H "Content-Type: application/json" -d '{"solve":"<identificador de resolución>"}'curl -s https://pokerai.bet/v1/gto/solver/node -H "Authorization: Bearer $POKERAI_API_KEY" -H "Content-Type: application/json" -d '{"node":"<token de nodo de un árbol consultable>"}'Para un nodo de Hero, la forma de éxito documentada tiene strategy. Para un nodo de villano, o cuando se omite hole_cards, la respuesta documentada puede proporcionar actions y range_strategy. Consume solo los campos documentados por el contrato OpenAPI actual.
Estado y gestión de errores
| Señal | Significado | Qué hacer |
|---|---|---|
computing | La resolución o el nodo todavía se está procesando. | Consulta el árbol de nuevo; no solicites la estrategia como si estuviera completa. |
queryable | El árbol está listo para inspeccionarse. | Selecciona un token de nodo devuelto y llama a /v1/gto/solver/node. |
no_nodes | La ronda o el runout consultado no tiene nodos de decisión. | Deja de consultar esa ronda o runout. |
expired | La resolución se recuperó o reemplazó. | Programa una nueva resolución; el identificador antiguo no se puede consultar. |
error | El nodo informa de un error de estrategia, opcionalmente con message. | Trátalo como un nodo fallido; no lo presentes como estrategia. |
HTTP 429 con status: busy | Todos los hosts del solver están ocupados. | Reintenta con retroceso; esto no supone un cargo de cuota. |
HTTP 503 | El upstream del árbol o nodo no está disponible. | Trátalo como transitorio y reintenta con retroceso cuando corresponda. |
Cuota y recursos relacionados
Una resolución nueva consume el contador de resoluciones en tiempo real; la reutilización de resoluciones en caché y las lecturas de árbol/nodo del solver son gratuitas. Consulta el tema de cuotas para conocer los contadores mensuales actuales.
- Centro de documentación — conceptos y autenticación de la API.
- Cuotas — límites gratuitos y gestión de
busy. - Referencia de la API — esquemas de operaciones actuales del solver.
- Instantánea de OpenAPI — contrato legible por máquina del ciclo de vida del solver.
- Guía de la API del solver GTO — una guía de implementación relacionada.
- Python SDK, TypeScript / JavaScript SDK y servidor MCP — puntos de entrada oficiales de los paquetes.
Real-time assistance at real-money tables is prohibited.