← Todos os guias
Nesta página
Guia Semântica do poker · 06/09 Ferramentas de torneio 9 min Intermediário

Como calculo o ICM de torneios com a API PokerKit?

Envie as premiações ordenadas do torneio e as pilhas de fichas para POST /v1/pokerkit/icm a fim de receber valores de equity ICM na mesma ordem dos jogadores.

Atualizado Mantido por Pokerai API

Resposta direta: envie arrays correspondentes de payouts e chips. Na resposta documentada, cada valor em result.icm corresponde, pela posição no array, ao stack de fichas enviado por esse jogador e à estrutura de premiação do torneio.

Fatos rápidos

EndpointPOST /v1/pokerkit/icm
Entradas necessáriaspayouts e chips, ambos arrays de números no esquema OpenAPI público
RespostaUm objeto result com um array de números icm
Limite de usoCálculo de equity de torneio para treinamento, coaching, revisão de mãos, estudo e pesquisa; sem assistência em tempo real para jogos a dinheiro real

Semântica de entrada

chips fornece as pilhas de fichas do torneio, e payouts fornece os valores de premiação. Ambos os campos são exigidos pelo esquema público IcmRequest. Mantenha a ordem dos jogadores estável: a resposta documentada retorna uma matriz icm, portanto suas posições são interpretadas em relação às posições de chips enviadas.

Solicitação e resposta mínimas

Use JSON e uma chave de API. Esta solicitação e esta resposta são o exemplo de código da documentação pública de pokerkitIcm.

curl -s https://pokerai.bet/v1/pokerkit/icm \
  -H "Authorization: Bearer $POKERAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"payouts":[50,30,20],"chips":[5000,3000,2000]}'
{"result":{"icm":[38.392857142857146,32.75,28.857142857142854]}}

Interpretando a equidade ICM

No exemplo, a primeira pilha enviada, 5000, corresponde ao primeiro valor de ICM retornado, 38.392857142857146; a segunda e a terceira posições correspondem da mesma forma. Trate esses valores como a saída de equidade de ICM do endpoint para esta entrada de premiação e pilhas. Não os renomeie como contagens de fichas, uma probabilidade de vitória, uma estratégia do solver ou uma ação de poker recomendada.

Escopo e uso

Use este endpoint quando um fluxo de treinamento de torneio, coaching ou revisão de mão concluída precisar de um cálculo de equidade ICM a partir de uma estrutura de premiação e um conjunto de stacks informados. Ele não fornece Ranges de mãos, cartas, ações de aposta, estratégia de torneio nem uma recomendação durante o jogo. Mantenha-o fora da assistência a decisões ao vivo com dinheiro real.

Cotas e erros

Este endpoint usa a mesma chave de API e o mesmo sistema de cotas de conta da API pública PokerKit. Consulte a documentação de cotas, os preços e o painel para ver os limites atuais da conta, em vez de codificar um limite fixo.

O contrato público OpenAPI declara uma resposta de erro de validação 422. Verifique se ambas as matrizes exigidas estão em conformidade com o esquema atual da Referência ou do OpenAPI antes de corrigir e reenviar uma solicitação. Para autenticação e tratamento da cota da conta, use a documentação de erros atual; não tente novamente uma solicitação inválida sem alterações.

Sem RTA com dinheiro real

A Pokerai API destina-se apenas a treinamento, coaching, revisão de mãos, estudo e pesquisa. Assistência em tempo real em mesas com dinheiro real é proibida. Não transforme a saída de ICM em uma instrução de ação em mesa ao vivo ou sinal de automação.

Recursos relacionados

Use os contratos públicos atuais e a documentação da conta junto com este Guia.

RecursoO que abrangeUse para
POST /v1/pokerkit/icmCálculo de equidade ICM a partir de payouts e chipsInspeção do contrato público atual de solicitação e resposta

SDK, MCP e recursos relacionados