¿Cómo creo un flujo de trabajo de API para revisar manos de póker?

Crea un flujo de revisión posterior a la sesión que acepte únicamente una mano completada, use datos deterministas de la API para sus cartas, mesa, equidad y estrategia, y después añada una consulta GTO una vez que el usuario haya elegido una situación para estudiar.

Actualizado 28 de julio de 2026Mantenido por Pokerai API

Respuesta breve: Mantén el flujo de trabajo asincrónico y orientado al estudio: analiza o reproduce la mano completada, muestra la semántica verificable de las cartas y la equidad, y luego consulta una situación GTO coincidente para obtener una explicación. Pokerai API proporciona los datos; un LLM puede explicarlos u orquestarlos, pero no sustituye al solver. Mantén los resultados de alto impacto bajo revisión humana y no conviertas esto en consejos en tiempo real en una mesa de dinero real.

Datos rápidos

Análisis de manos	`POST /v1/pokerkit/notation/parse` analiza la notación pública de Poker Hand History y la convierte en datos estructurados del juego.
Repetición	`POST /v1/pokerkit/games/state` devuelve una instantánea que incluye el bote, los stacks, el board, las hole cards y las acciones legales para las acciones enviadas.
Semántica	`POST /v1/pokerkit/hand-report` devuelve la textura, el nivel, los proyectos, las outs y los bloqueadores de una mano con cartas privadas y mesa.
Equidad	`POST /v1/pokerkit/equity` devuelve las equities de Montecarlo y el recuento de muestras.
Consulta GTO	`POST /v1/gto/preflop` devuelve una estrategia mixta presuelta para una línea de acción preflop documentada.

1. Analiza o reproduce la mano completada

Guarda una mano solo después de la sesión y, a continuación, pasa su texto de Poker Hand History al analizador de notación. Para una cronología de revisión, envía la configuración estructurada y las acciones al endpoint de estado del juego; su instantánea proporciona a la UI una vista factual del bote, los stacks, el board, las cartas ocultas y las acciones legales.

{"text": "variant = \"NT\"\nante_trimming_status = true\nantes = [0, 0]\nblinds_or_straddles = [1, 2]\nmin_bet = 2\nstarting_stacks = [200, 200]\nactions = [\"d dh p1 AhKh\", \"d dh p2 QsQd\", \"p1 cbr 6\", \"p2 cc\", \"d db Qh7c2d\"]\n"}

{"result": {"variant": "NT", "ante_trimming_status": true, "antes": [0, 0], "blinds_or_straddles": [1, 2], "bring_in": null, "small_bet": null, "big_bet": null, "min_bet": 2, "starting_stacks": [200, 200], "actions": ["d dh p1 AhKh", "d dh p2 QsQd", "p1 cbr 6", "p2 cc", "d db Qh7c2d"], "automations": [{"name": "ANTE_POSTING", "value": "Ante posting"}, …], "author": null, "event": null, "day": null, "month": null, "year": null, "hand": null, "currency": null}}

2. Explica la semántica del board y de la mano

En la calle seleccionada, llama al endpoint de informe de mano con las hole del jugador y el board. Muestra la textura devuelta, el nivel de mano hecha, los proyectos, outs y bloqueadores como etiquetas y evidencia; no infieras una recomendación a partir de estos campos descriptivos.

{"hole": "JhTh", "board": "AsKsQs"}

{"result": {"texture": {"cards": ["As", "Ks", "Qs"], "wetness": {"name": "WET", "value": "Wet"}, "connectivity": {"name": "HIGH", "value": "High"}, "rank_band": {"name": "HIGH", "value": "High"}, "straight_draw": {"name": "OPEN_ENDED", "value": "Open-ended"}, "flush_draw": {"name": "LIVE", "value": "Live"}, "are_two_tone": false, "are_monotone": true, "are_rainbow": false}, "tier": {"category": {"name": "STRAIGHT", "value": "Straight"}, "is_nut": false, "pair_tier": null, "two_pair_tier": null, "three_of_a_kind_tier": null, "kicker_tier": null, "nut_rank": {"name": "NON_NUT", "value": "Non-nut"}}, "draws": {"straight_draw": null, "flush_draw": null, "nut_rank": null}, "outs": {"by_category": {}, "count": 0}}}

3. Estima la equidad con su contexto de muestreo

Para una comparación de revisión, envía los rangos conocidos, la mesa, el recuento de muestras y la semilla al endpoint de equidad. Muestra cada equidad devuelta junto a sample_count; es una estimación para los rangos y la mesa proporcionados, no una promesa sobre la siguiente carta ni una instrucción de apuesta.

{"ranges": [["AA"], ["KK"]], "board": "", "sample_count": 2000, "seed": 7}

{"result": {"equities": [0.8235, 0.1765], "sample_count": 2000}}

4. Adjunta una consulta GTO para la explicación de la revisión

Relaciona una línea de acción preflop reconstruida con la consulta preflop documentada. Muestra la matriz de estrategia devuelta como frecuencias mixtas y explica que el usuario elige según la frecuencia; mantén este paso de revisión separado del juego en vivo.

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

5. Crea una interfaz de explicaciones, no una indicación de acción

Muestra una secuencia estable: cronología de la mano, datos de las cartas comunitarias y de la mano, estimación de equity y, después, las frecuencias de la estrategia GTO. Etiqueta las entradas, los campos devueltos, la calle y los supuestos. Presenta alternativas y frecuencia en lugar de un único botón de «jugar ahora».

Solo para entrenamiento y revisión

Acepta solo manos que ya hayan terminado y usa este flujo de trabajo para capacitación, coaching, revisión de manos, estudio e investigación después de una mano. Exige revisión humana para resultados de coaching o de producto con consecuencias. Se prohíbe la asistencia en tiempo real en mesas con dinero real. No ingieras una transmisión de mesa en vivo, no selecciones automáticamente una acción ni expongas una interfaz de recomendaciones durante la mano.

Recursos relacionados

Documentación para desarrolladores — autenticación, cuotas, SDKs, errores y comportamiento de la API
Referencia interactiva de la API — los esquemas actuales de los endpoints públicos
Especificación OpenAPI — el contrato en inglés legible por máquina
Guía de la API de estrategia preflop — cómo reconstruir y consultar una línea de acción preflop
Guía de MCP de Pokerai — añade la orquestación de agentes solo después de que el flujo de revisión de manos completadas esté implementado
llms.txt — el punto de entrada conciso de LLM para Pokerai API