← Todos os guias
Nesta página
  1. Início
  2. Guias
  3. Como calculo a equidade de Ranges de poker com uma API?
Guia Semântica do poker · 08/09 Ferramentas de Ranges 11 min Intermediário

Como calculo a equidade de Ranges de poker com uma API?

Envie a Range de cada jogador, um board opcional e controles reproduzíveis de Monte Carlo ao endpoint de equidade do PokerKit; use as participações retornadas para explicar um cenário fornecido, não para prever um resultado.

Atualizado Mantido por Pokerai API

Resposta direta: chame POST /v1/pokerkit/equity com ranges contendo um array de notação para cada jogador. Opcionalmente, inclua um board, sample_count e seed. A resposta retorna uma equidade de Monte Carlo para cada Range fornecido, além da contagem de amostras usada.

Fatos rápidos

EndpointPOST /v1/pokerkit/equity
EntradaDois ou mais Ranges de jogadores na notação de Ranges do PokerKit, um por jogador; board é opcional.
MétodoEstimativa de equidade por Monte Carlo. Ela retorna uma estimativa para os Ranges e o board fornecidos, não uma garantia de probabilidades.
Respostaresult.equities é ordenado para corresponder a ranges; result.sample_count informa o contexto da amostragem.
CotaEste endpoint consome 1 unidade da cota de resoluções. O plano Free atual inclui 25 resoluções em tempo real por mês.
AcessoOs endpoints PokerKit e GTO usam a mesma chave de API. Envie um cabeçalho de chave de API compatível.

Semântica de entrada

Use um array de Ranges aninhado para cada jogador. A ordem dos arrays é significativa porque as equidades retornadas seguem a mesma ordem. Um board, quando fornecido, é uma string de cartas sem separadores como AhKhQh.

CampoSignificado
rangesObrigatório. Arrays por jogador de strings de notação de Range, por exemplo [["AA"], ["KK"]].
boardString de cartas opcional para o board conhecido; omita ou use uma string vazia quando nenhum board for conhecido.
sample_countContagem opcional de amostras Monte-Carlo. O limite de serviço documentado se aplica; o padrão é usado quando ela não é definida.
seedSeed opcional para amostragem reproduzível.

Solicitação mínima da API

Este exemplo de código da documentação pública compara AA e KK antes do board, com uma contagem de amostras e uma seed fixas. Adicione sua chave de API como o cabeçalho de autenticação ao fazer a solicitação HTTP.

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

Exemplo de resposta e interpretação

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

O primeiro valor, 0.8235, corresponde ao primeiro Range de entrada (AA); o segundo, 0.1765, corresponde a KK. Preserve essa ordem na sua interface ou relatório.

Leia sample_count: 2000 como o número de amostras de Monte Carlo usadas nesta resposta. Ele descreve o contexto de amostragem desta estimativa; não é uma promessa sobre uma futura distribuição de cartas, uma aposta ou desempenho.

Quando usar isto

Use o endpoint em produtos de treinamento, revisão de mãos concluídas, ferramentas de coaching, pesquisa ou uma interface de explicação em que os Ranges e o board estejam explícitos para o usuário. Armazene as entradas fornecidas ao lado do resultado para que a estimativa permaneça auditável.

Quando não usar isto

Não use uma estimativa de equity como um estímulo para ação em uma mão valendo dinheiro real; ela não substitui o julgamento do jogador, um modelo de jogo completo ou uma estratégia de solver. Não dê a entender que uma estimativa garante uma vitória, uma carta futura ou um resultado de aposta.

Cota e autenticação

Envie Authorization: Bearer $POKERAI_API_KEY (ou o equivalente X-API-Key) com a solicitação. O endpoint consome 1 cota de resolução; o nível Free atual tem 25 resoluções em tempo real por mês. Verifique o uso atual no painel e leia o tópico sobre cotas antes de planejar o trabalho em lote.

Erros

HTTPSignificadoO que fazer
401missing_api_key ou invalid_api_key.Envie um cabeçalho API-key válido e mantenha a chave fora dos logs do cliente.
Cotaquota_exceeded quando a cota mensal aplicável estiver esgotada.Aguarde a redefinição mensal ou ajuste a carga de trabalho; não tente novamente solicitações inalteradas.
422A validação da solicitação falhou, por exemplo, devido a um formato de corpo inválido.Consulte o esquema Reference ou OpenAPI atual e corrija a entrada.

Somente treinamento e revisão

Use a Pokerai API para treinamento, coaching, revisão de mãos, estudo e pesquisa. Assistência em tempo real em mesas com dinheiro real é proibida. Mantenha as exibições de equity fora da automação de mesas ao vivo e não as transforme em uma recomendação de ação.

Recursos relacionados