Crea un producto de análisis de póker en tiempo real y con baja latencia con la API Cache de PokerAI
Muestra las frecuencias de acción en cuanto llegue la estrategia. Una mano real de 200NL en un bote 3-bet te lleva del catálogo a las tres calles, con consultas separadas de EV y equity.
/cache/query. Llama a /cache/ev o /cache/eq cuando el usuario abra el panel correspondiente, para que pueda explorar la mano mientras se carga la métrica.Cuándo usar la API Cache
Este flujo sirve para mostrar la estrategia de las tres calles directamente. Cuando una situación está resuelta de antemano por completo, el flop, el turn y el river se resuelven juntos en un solo árbol posflop. La API lee nodos de esa misma solución al cambiar las cartas o las acciones, manteniendo la coherencia del equilibrio entre calles. La aproximación al equilibrio de Nash depende de los rangos, las fichas, los tamaños del árbol y la precisión del solver.
Las consultas de estrategia y las de EV o equity por separado requieren Builder o Pro. Cualquier clave API válida puede consultar el catálogo gratis. Solo hay resultados guardados para parte de las situaciones. El catálogo enumera las raíces disponibles. La respuesta de estrategia indica qué acciones o cartas se pueden seguir.
Datos clave de una mano de 200NL en bote 3-bet
Usamos el paquete preflop 6max_RC_100bb_200NL. MP abre y SB resube con A♥K♥. El flop es 4♣8♦9♥. Hay 19 BB en el bote y quedan 91 BB efectivos.
| Calle y cartas | Acción | Siguiente |
|---|---|---|
| Flop4♣ 8♦ 9♥ | SB apuesta 13 BB MP paga | Sale A♠ |
| TurnA♠ | SB apuesta 14 BB MP paga | Sale 7♦ |
| River7♦ | SB apuesta 22 BB MP paga | Showdown |
Seguiremos la línea de 13, 14 y 22 BB, con un call de MP en cada calle. En el river, A♥K♥ pasa la mayoría de las veces. En este ejemplo seguimos la apuesta de 22 BB hasta el showdown.
Encuentra un escenario con cobertura
Envía el paquete preflop y el flop a /cache/coverage para ver qué escenarios tienen una estrategia guardada. Cualquier clave API válida puede consultar el catálogo sin gastar cuota de presolved, solve ni cache.
curl -G 'https://pokerai.bet/v1/gto/postflop/cache/coverage' \
-H "Authorization: Bearer $POKERAI_API_KEY" \
--data-urlencode 'preflop_pack=6max_RC_100bb_200NL' \
--data-urlencode 'board=4c8d9h' \
--data-urlencode 'limit=200'
preflop_pack y board son obligatorios. El catálogo devolvió esta entrada para la mano. Captura original con la respuesta del catálogo.
{
"preflop_pack": "6max_RC_100bb_200NL",
"board": "4c8d9h",
"pot_type": "3BET",
"positions": {"raiser": "MP", "three_bettor": "SB", "hero": "SB"}
}
Cuando se elija «MP abre · SB hace 3-bet», usa esos campos para solicitar el nodo raíz. Mantén el mismo paquete y el mismo flop al paginar y pasa next_cursor tal cual en cursor. Una página con items vacío aún puede tener continuación. Termina cuando next_cursor sea null. Si no hay coincidencias, indica que el escenario no tiene estrategia guardada y deja que el usuario elija si quiere resolverlo en ese momento.
Carga la estrategia del flop
Llama a /cache/query desde tu backend y guarda la clave API allí. Añade hole_cards: "AhKh" para obtener la estrategia de A♥K♥.
- 1. Busca el escenario
/cache/coverageCatálogo gratuito - 2. Carga y muestra la estrategia
/cache/queryUna consulta por raíz y carta nueva. Las acciones normales son gratuitas. - 3. Consulta las métricas necesarias
/cache/evo/cache/eqUna consulta por petición admitida
Abrir el nodo raíz consume una consulta de cache.
POST /v1/gto/postflop/cache/query
{
"preflop_pack": "6max_RC_100bb_200NL",
"board": "4c8d9h",
"pot_type": "3BET",
"positions": {"hero": "SB", "raiser": "MP", "three_bettor": "SB"},
"hole_cards": "AhKh"
}
Muestra las frecuencias de strategy y conserva el token. El valor node: "root" de la respuesta te sirve para etiquetar la ruta; en la siguiente petición, el campo node lleva el token correspondiente. Si ya tienes la matriz del rango completo, puedes cambiar de mano sin pedirla de nuevo: basta con leer su fila. Vuelve a consultar cuando cambie el nodo de acción o salga otra carta.
Sigue la acción en turn y river
Con A♥K♥, SB apuesta 13 BB en el flop aproximadamente el 69,02 % de las veces. MP paga y cae A♠. SB apuesta 14 BB un 77,65 % de las veces. MP vuelve a pagar. En 7♦, SB pasa un 88,63 % de las veces. Aquí seguimos la apuesta de 22 BB (10,20 %) y el call.
- Check 23,53 %
- Apuesta 6 BB 7,45 %
- Apuesta 13 BB 69,02 %
- All-in 0,00 %
- Check 1,96 %
- Apuesta 14 BB 77,65 %
- Apuesta 31 BB 20,39 %
- All-in 0,00 %
- Check 88,63 %
- Apuesta 22 BB 10,20 %
- All-in 1,18 %
Para avanzar tras una apuesta o un call, usa el token de la rama de esa acción como node. Al llegar a un nodo chance, envía su token junto a turn_card o river_card. La función query del ejemplo llama a /cache/query. Ejemplo completo en Node.js con autenticación y manejo de errores.
const opponent = await query("flop-bet", {
node: cachedAction(flop, "bet", 13),
});
const chance = await query("flop-call", {
node: cachedAction(opponent, "call"),
});
const turn = await query("turn-deal", {
node: chance.token,
turn_card: "As",
hole_cards: "AhKh",
});
Las consultas de apuesta y call son gratuitas con un token válido. Seleccionar una carta nueva de turn o river consume una consulta de cache. Conserva la secuencia de acciones para que el usuario pueda volver a un nodo que ya visitó.
Consulta EV y equity cuando hagan falta
/cache/ev devuelve el valor esperado de las acciones y /cache/eq devuelve la equity de la mano. Ambos reciben el token del nodo action actual y una mano concreta. El token determina el paquete, las cartas comunitarias y los rangos.
const hand = { node: flop.token, hole_cards: "AhKh" };
const ev = await http("flop-ev", "/v1/gto/postflop/cache/ev", hand);
const actionValues = ev.ev.status === "ok" ? ev.ev.action_values : null;
const eq = await http("flop-eq", "/v1/gto/postflop/cache/eq", hand);
const equityPercent = eq.eq.status === "ok" ? eq.eq.value * 100 : null;
/cache/query sirve la estrategia. Los parámetros antiguos include_ev:true e include_eq:true devuelven HTTP 400 sin gastar cuota ni iniciar cálculos. Omítelos o conserva false en clientes antiguos.
El EV es el beneficio neto en BB bajo la estrategia guardada. La EQ usa las cartas comunitarias actuales y el rango del rival en el nodo raíz del flop, que permanece fijo a lo largo de la línea.
| Nodo y acción anterior | EV de A♥K♥ | EQ |
|---|---|---|
| Flop 4♣8♦9♥ (primera medición) | −6,4512 BB | 44,5677 % |
| Turn A♠ (apuesta de 13 BB y call) | 18,8904 BB | 83,2143 % |
| River 7♦ (después, 14 BB y call) | 5,3115 BB | 73,4660 % (verificación) |
Para comparar acciones del mismo nodo, usa action_values en la respuesta EV. Respuestas de las métricas medidas.
Tiempos de respuesta y consumo
En la misma ronda del flop, la estrategia llegó en 4,425 s, el EV en 14,184 s y la EQ en 8,566 s. Al verificar el river, la estrategia llegó en 1,319 s tras pedir la carta y la EQ tardó 6,827 s. Muestra las frecuencias en cuanto lleguen y solicita el EV o la EQ solo cuando se abra ese panel.
| Petición | Tiempo | Serie | |
|---|---|---|---|
| Flop4♣ 8♦ 9♥ | |||
| Estrategia · raíz | 4,425 s | A | |
| EV | 14,184 s | A | |
| EQ | 8,566 s | A | |
| TurnA♠ | |||
| Estrategia · carta | 1,348 s | B | |
| EV | 6,983 s | B | |
| EQ | 6,482 s | B | |
| River7♦ | |||
| Estrategia · carta | 1,319 s | C | |
| EV | 6,519 s | B | |
| EQ | 6,827 s | C | |
Cada barra es una petición HTTPS pública que terminó correctamente, cronometrada hasta recibir toda la respuesta. Los tiempos varían según el nodo y el estado del servicio.
| Operación | Consultas de cache consumidas |
|---|---|
Consultar /cache/coverage |
0 |
Abrir un nodo raíz con /cache/query |
1 |
| Seguir una acción con un token válido | 0 |
Pedir otra carta de turn o river con /cache/query |
1 por petición |
| Enviar una petición EV o EQ que supere la admisión | 1 por petición |
La estrategia de las tres calles consume tres consultas de cache. Con EV y EQ en cada calle, el total es nueve. La verificación del river consumió cuatro con una sola consulta EQ. El call del turn se consultó en 1,317 s y no gastó cuota.
Las entradas inválidas, los tokens caducados y otros rechazos previos a la admisión no gastan cuota. Puede haber errores después de descontarla. Comprueba cache_quota cuando esté presente y evita los reintentos automáticos. Volver a enviar la petición cuenta como una nueva.
Ejecuta el ejemplo completo
Guarda juntos las posiciones, la mano, las cartas comunitarias y la secuencia de acciones. Así puedes mantener visible la estrategia mientras se cargan EV y EQ o si una métrica falla.
Descarga el ejemplo en Node.js. Localiza el escenario, sigue las tres apuestas y sus calls hasta el showdown y solicita después EV y EQ en cada calle. Si basta una página del catálogo y todo sale bien, son 16 peticiones y nueve consultas de cache.
Si lo ejecutas contra producción, usa una clave Builder o Pro. Se gastará cuota de esa cuenta. El script se detiene al primer error y conserva los resultados que ya imprimió.
export POKERAI_API_KEY='YOUR_SERVER_API_KEY'
node reproduce.mjs
Datos de producción y cómo citarlos
Las mediciones son del 18 de noviembre de 2026. En la captura original hubo 13 respuestas correctas y un HTTP 503 para la EQ del river. Los ocho intentos de la verificación posterior funcionaron con tokens nuevos y la misma línea. Se gastó una consulta en el nodo raíz, en cada carta nueva y en la EQ del river.
- Mediciones y métricas del flop
- Extractos de peticiones y respuestas de la línea original
- Extractos de las ocho peticiones de verificación de EQ en el river
Si citas una medición, incluye el paquete, las cartas comunitarias, las acciones, la fecha y cómo se tomó el tiempo. Son observaciones de peticiones individuales. Este flujo está pensado para entrenamiento, investigación y revisión de manos después de jugar. Está prohibida la asistencia en tiempo real en mesas con dinero real.
Documentación de la API · Referencia de la API · OpenAPI · llms.txt
Sigue con el solver en tiempo real si falta la situación
Si no encuentras la situación guardada, usas Free o Starter, o quieres cambiar los rangos o tamaños de las calles posteriores, muestra primero la estrategia precalculada del flop y resuelve el resto según haga falta.
Cómo crear análisis de póker de baja latencia con datos precalculados y el solver en tiempo real. La guía complementaria usa la misma mano 3-bet de 200NL para mostrar cómo trasladar ambos rangos y cuándo presentar la estrategia del turn y del river.