Crie um produto de análise de pôquer em tempo real e com baixa latência com a API Cache da PokerAI
Mostre as frequências das ações assim que a estratégia chegar. Acompanhe uma mão real de 200NL em pote 3-bet, da busca por cobertura até a consulta de EV e equidade sob demanda.
/cache/query responder. Chame /cache/ev ou /cache/eq quando a pessoa abrir o painel correspondente. Assim ela pode explorar a mão enquanto a métrica carrega.Quando usar a API Cache
Use esse fluxo para exibir a estratégia das três streets. Em um cenário já resolvido por completo, flop, turn e river são calculados juntos na mesma árvore pós-flop. A API lê os nós dessa solução conforme mudam o board e a ação, preservando a consistência do equilíbrio entre as streets. A aproximação do equilíbrio de Nash depende dos ranges, stacks, tamanhos da árvore e precisão do solver.
As consultas de estratégia e de EV ou equidade em endpoints separados exigem Builder ou Pro. Qualquer chave de API válida pode consultar a cobertura de graça. O cache cobre apenas parte dos cenários. O catálogo lista as raízes disponíveis e a resposta de estratégia indica se uma ação ou carta pode ser consultada.
Fatos rápidos: uma mão de 200NL em pote 3-bet
A mão usa o pacote pré-flop 6max_RC_100bb_200NL. MP abre e SB dá 3-bet com A♥K♥. O flop é 4♣8♦9♥, com 19 BB no pote e 91 BB de stack efetivo para trás.
| Street e cartas | Ação | Depois |
|---|---|---|
| Flop4♣ 8♦ 9♥ | SB aposta 13 BB MP paga | Sai A♠ |
| TurnA♠ | SB aposta 14 BB MP paga | Sai 7♦ |
| River7♦ | SB aposta 22 BB MP paga | Showdown |
Vamos seguir as apostas de 13, 14 e 22 BB, com MP pagando nas três streets. No river, A♥K♥ dá check na maioria das vezes. Aqui, seguimos a aposta de 22 BB até o showdown.
Encontre um cenário com cobertura
Envie o pacote pré-flop e o flop para /cache/coverage e veja quais cenários já têm estratégia salva. Qualquer chave de API válida pode consultar o catálogo sem gastar cota de presolved, solve ou 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 e board são obrigatórios. O catálogo retornou o item abaixo para esta mão. Captura original com a resposta do catálogo.
{
"preflop_pack": "6max_RC_100bb_200NL",
"board": "4c8d9h",
"pot_type": "3BET",
"positions": {"raiser": "MP", "three_bettor": "SB", "hero": "SB"}
}
Quando a pessoa selecionar “MP abre · SB dá 3-bet”, use os campos retornados para consultar o nó raiz. Ao paginar, mantenha o mesmo pacote e flop. Passe next_cursor sem alterações no campo cursor. Mesmo com items vazio, prossiga se houver outro cursor. Pare em next_cursor: null. Se não encontrar o cenário, informe que não há estratégia salva e deixe a pessoa decidir se quer rodar um cálculo.
Carregue a estratégia do flop
Chame /cache/query no seu backend e mantenha a chave da API no servidor. Use hole_cards: "AhKh" para obter a estratégia de A♥K♥.
- 1. Encontre o cenário
/cache/coverageCatálogo gratuito - 2. Carregue e mostre a estratégia
/cache/queryUma consulta por raiz e por carta nova. Ações normais são gratuitas. - 3. Busque métricas sob demanda
/cache/evou/cache/eqUma consulta por requisição admitida
Abrir o nó raiz consome uma 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"
}
Mostre as frequências de strategy e guarde o token. Na resposta, node: "root" pode servir de rótulo para o caminho. Para continuar, envie o token do nó escolhido no campo node. Caso já tenha carregado a matriz para o range inteiro, basta ler a linha correspondente ao trocar de mão. Consulte de novo ao mudar de nó ou de carta.
Siga a ação até o river
Com A♥K♥, SB aposta 13 BB no flop cerca de 69,02% das vezes. MP paga e sai A♠. A frequência de apostar 14 BB no turn é 77,65%. MP paga de novo. No 7♦, SB dá check 88,63% das vezes. O exemplo segue o ramo da aposta de 22 BB (10,20%) e o call.
- Check 23,53%
- Aposta 6 BB 7,45%
- Aposta 13 BB 69,02%
- All-in 0,00%
- Check 1,96%
- Aposta 14 BB 77,65%
- Aposta 31 BB 20,39%
- All-in 0,00%
- Check 88,63%
- Aposta 22 BB 10,20%
- All-in 1,18%
Para avançar após uma aposta ou call, use como node o token do filho correspondente. Ao chegar a um nó chance, mande o token junto de turn_card ou river_card. A função query do trecho chama /cache/query. Exemplo completo em Node.js com autenticação e tratamento de erros.
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",
});
As consultas de aposta e call são gratuitas com um token válido. Cada nova carta de turn ou river consome uma consulta de cache. Guarde a sequência de ações para permitir que a pessoa volte a um nó que já viu.
Busque EV e equidade sob demanda
Use /cache/ev para consultar o valor esperado das ações e /cache/eq para obter a equidade da mão. Cada endpoint recebe o token do nó action atual e uma mão específica. O token determina o pacote, o board e os ranges.
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 entrega a estratégia. As opções antigas include_ev:true e include_eq:true retornam HTTP 400 sem gastar cota nem iniciar cálculos. Omita essas opções ou mantenha false em clientes já existentes.
EV é o ganho líquido em BB sob a estratégia salva. A EQ usa as cartas comunitárias atuais e o range do adversário no nó raiz do flop, que permanece fixo ao longo das ações.
| Nó e ação anterior | EV de A♥K♥ | EQ |
|---|---|---|
| Flop 4♣8♦9♥ (medição anterior) | −6,4512 BB | 44,5677% |
| Turn A♠ (aposta de 13 BB e call) | 18,8904 BB | 83,2143% |
| River 7♦ (mais 14 BB e call) | 5,3115 BB | 73,4660% (nova verificação) |
Para comparar as ações no mesmo nó, consulte action_values na resposta de EV. Respostas das métricas medidas.
Tempo de resposta e cota
Na mesma rodada de medição do flop, a estratégia chegou em 4,425 s, o EV em 14,184 s e a EQ em 8,566 s. Na verificação do river, a estratégia chegou em 1,319 s depois de pedir a carta. A EQ levou 6,827 s. Mostre as frequências assim que chegarem e peça EV ou EQ quando a pessoa abrir o painel correspondente.
| Pedido | Tempo | Série | |
|---|---|---|---|
| Flop4♣ 8♦ 9♥ | |||
| Estratégia · raiz | 4,425 s | A | |
| EV | 14,184 s | A | |
| EQ | 8,566 s | A | |
| TurnA♠ | |||
| Estratégia · carta | 1,348 s | B | |
| EV | 6,983 s | B | |
| EQ | 6,482 s | B | |
| River7♦ | |||
| Estratégia · carta | 1,319 s | C | |
| EV | 6,519 s | B | |
| EQ | 6,827 s | C | |
Cada barra representa uma requisição HTTPS pública bem-sucedida, medida até o fim da resposta. Os tempos variam conforme o nó e as condições do serviço.
| Operação | Cota de cache consumida |
|---|---|
Consultar /cache/coverage |
0 |
Abrir um nó raiz com /cache/query |
1 |
| Seguir uma ação com token válido | 0 |
Pedir uma nova carta de turn ou river com /cache/query |
1 por requisição |
| Enviar uma requisição de EV ou EQ admitida | 1 por requisição |
A estratégia das três streets consome três consultas de cache. Com EV e EQ em todas, o total sobe para nove. A verificação do river consumiu quatro, incluindo uma consulta de EQ. A leitura do call no turn levou 1,317 s e não consumiu cota.
Dados inválidos, tokens expirados e outras rejeições antes da admissão não consomem cota. Um erro pode chegar depois do débito. Confira cache_quota quando disponível e evite tentativas automáticas. Reenviar gera uma nova requisição.
Rode o exemplo completo
Guarde juntos as posições, as cartas e a sequência de ações. Dê a EV e EQ estados de carregamento e erro próprios, para que a estratégia continue disponível mesmo se alguma métrica falhar.
Baixe o exemplo em Node.js. Ele encontra o cenário, acompanha as apostas e calls até o showdown e depois consulta EV e EQ nas três streets. Com uma página de catálogo e todas as etapas bem-sucedidas, são 16 requisições e nove consultas de cache.
Para rodar em produção, use uma chave Builder ou Pro. A execução usa a cota da conta. Se houver erro, o script para e mantém os resultados já impressos.
export POKERAI_API_KEY='YOUR_SERVER_API_KEY'
node reproduce.mjs
Medições em produção e como citá-las
Os dados são de 18 de novembro de 2026. A captura original teve 13 respostas bem-sucedidas e um HTTP 503 na EQ do river. Na verificação posterior, as oito requisições funcionaram com novos tokens e o mesmo caminho. O nó raiz, cada carta nova e a EQ do river consumiram uma consulta cada.
- Medições e resultados do flop
- Trechos das requisições e respostas da linha original
- Trechos das oito requisições de verificação da EQ do river
Ao citar uma medição, inclua o pacote, o board, a sequência de ações, a data e o método de cronometragem. Os números representam requisições individuais. O fluxo serve para treino, pesquisa e revisão após a sessão. É proibido prestar assistência em tempo real em mesas a dinheiro real.
Documentação da API · Referência da API · OpenAPI · llms.txt
Continue com o solver em tempo real se faltar o cenário
Se o cenário estiver fora da cobertura, se você usa Free ou Starter ou quiser alterar os ranges e tamanhos das streets seguintes, comece com o flop pré-calculado e resolva as outras streets conforme a necessidade.
Como criar uma análise de pôquer de baixa latência com dados pré-calculados e o solver em tempo real. O guia complementar usa a mesma mão 3-bet de 200NL para mostrar como levar os dois ranges adiante e exibir as estratégias de turn e river.