Como calculo a equidade no poker com a Pokerai API?

Envie duas ou mais Ranges de jogadores ao endpoint público de equity do PokerKit; adicione um board, contagem de amostras e seed apenas quando seu caso de uso precisar deles.

Atualizado 26 de julho de 2026Mantido por Pokerai API

Resposta direta: chame POST /v1/pokerkit/equity com o array ranges obrigatório. É um cálculo de equidade por Monte Carlo, não uma recomendação GTO nem um assistente para jogo em tempo real.

Fatos rápidos

Fato	Valor
Operação	`POST /v1/pokerkit/equity`
Parâmetro obrigatório	`ranges`: arrays de notação de Ranges por jogador.
Parâmetros opcionais	`board` (o padrão é uma string vazia), `sample_count` e `seed`.
Método	Monte Carlo; a descrição do OpenAPI diz que `sample_count` tem limite máximo e que um valor não definido usa o padrão.
Reprodutibilidade	`seed` é o parâmetro público da solicitação para amostragem reproduzível.

Solicitação mínima à API

curl -s https://pokerai.bet/v1/pokerkit/equity \
  -H "Authorization: Bearer $POKERAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ranges":[["AA","KK"],["QQ","JJ"]]}'

O schema público EquityRequest exige apenas ranges. Adicione board para um board conhecido e sample_count ou seed somente quando os controles de amostragem documentados forem necessários.

Como interpretar a resposta

Uma resposta bem-sucedida é documentada como HTTP 200. O snapshot público do OpenAPI deixa intencionalmente seu schema de resposta aberto, portanto o código do cliente deve inspecionar o JSON retornado e evitar supor campos não documentados ou uma única ação recomendada. A equidade descreve os Ranges e as cartas enviados; não fornece estratégia GTO.

Erros, limites e uso seguro

HTTP	Contrato público	O que fazer
422	`HTTPValidationError`	Verifique o formato obrigatório de `ranges` e os tipos dos parâmetros fornecidos.
Amostragem	`sample_count` tem limite máximo	Não suponha que um valor enviado maior será usado; use a resposta da API e a referência para o comportamento atual.

Use este endpoint para treinamento, coaching, revisão de mãos, estudo e pesquisa. Assistência em tempo real em jogos com dinheiro real (RTA) é proibida. Esta página não publica permissões específicas de planos nem promete assistência em mesas ao vivo.

Documentação relacionada

Central de documentação — visão geral das APIs PokerKit e GTO.
Equidade ICM — cálculos determinísticos de premiações e fichas, distintos da equidade de Ranges.
Referência da API — formulário de solicitação por operação e detalhes atuais da resposta.
Snapshot do OpenAPI — o contrato público EquityRequest.

Real-time assistance at real-money tables is prohibited.