O que é uma API de solver de poker GTO para NLHE 6-max?
Uma API de solver de pôquer GTO permite que o software solicite dados documentados de estratégia para uma situação de pôquer especificada. A API Pokerai é uma API HTTP hospedada, não um download de solver para desktop: ela separa consultas de estratégias pré-resolvidas de solicitações de resolução personalizada para que produtos de treinamento, ferramentas de revisão e agentes possam usar respostas JSON sem incorporar software de solver local.
Fatos rápidos
| Produto | Pokerai API, hospedada em pokerai.bet |
|---|---|
| Escopo do jogo | Texas Hold'em Sem Limite 6-max: fluxos de pré-flop e flop pré-resolvidos, além de resoluções personalizadas de flop, turn e river |
| Resultado principal | Ações de frequência mista, ranges, nós ou EVs; em vez disso, os resultados de benchmark/jogabilidade medem uma avaliação ou simulação |
| Modelo de dados | Solicitações e respostas JSON sem estado com autenticação por token bearer |
| Interfaces para desenvolvedores | OpenAPI, JavaScript SDK, Python SDK, servidor MCP, documentação e referência da API ao vivo |
| Plano gratuito | 1.000 consultas pré-resolvidas + 25 resoluções em tempo real por mês; não é necessário cartão de crédito |
Escolha o tipo de API de acordo com a pergunta que você precisa responder
Use a API de estratégia quando um produto precisar de um resultado de estratégia documentado para uma situação. Os endpoints pré-resolvidos de pré-flop e flop retornam frequências mistas, Ranges, nós da árvore ou EVs; uma mão pode desistir, pagar e aumentar com frequências diferentes, em vez de ter uma única ação obrigatória.
Use a API de resolução personalizada somente quando o produto precisar enviar uma configuração documentada de flop, turn ou river. Ela primeiro retorna um identificador solve; o resultado da estratégia se torna legível somente depois que sua árvore estiver queryable. Use APIs de benchmark ou de jogabilidade para avaliação de agentes ou simulação de jogo. Suas pontuações, resultados ou trajetórias não são uma recomendação de GTO e não devem ser apresentados como tal.
Chamada mínima de estratégia e semântica dos resultados
Para uma consulta de estratégia pré-flop pré-resolvida, envie uma situação documentada para POST /v1/gto/preflop:
curl -s https://pokerai.bet/v1/gto/preflop -H "Authorization: Bearer $POKERAI_API_KEY" -H "Content-Type: application/json" -d '{"hole_cards":"AsKs","positions":{"hero":"BTN"},"preflop_actions":[{"position":"SB","action":"small blind","amount":0.5},{"position":"BB","action":"big blind","amount":1},{"position":"UTG","action":"fold"},{"position":"MP","action":"fold"},{"position":"CO","action":"fold"}]}'
Leia a resposta documentada como uma distribuição: as frequências de ação descrevem a combinação de estratégias para essa solicitação, enquanto os campos de cota informam o uso em vez da qualidade da estratégia. Para uma situação personalizada em uma rodada posterior, POST /v1/gto/solver agenda o trabalho; siga o ciclo de vida do solver para consultar repetidamente o estado da árvore e ler um token de nó retornado.
Cobertura, cotas, SDKs e MCP
A superfície pública de GTO abrange solicitações pré-resolvidas de pré-flop e flop, agendamento e leituras de resoluções personalizadas de flop/turn/river, transformações de Ranges, Ranges projetados e consultas de EV. Consulte a Referência da API ou o snapshot do OpenAPI para os esquemas atuais, em vez de presumir um formato de jogo, campo ou latência não documentado.
O plano gratuito inclui 1.000 consultas pré-resolvidas + 25 resoluções em tempo real por mês. SDKs de JavaScript/TypeScript e Python expõem o mesmo contrato público para código de aplicação; o servidor MCP o expõe como ferramentas para agentes compatíveis. Um agente ainda precisa de entradas validadas e revisão humana para explicações com consequências.
Quando não usar esta página
Escolha a comparação entre API hospedada e solver para desktop quando a decisão envolver controle de pesquisa, construção local da árvore e trade-offs de integração. A Pokerai não oferece um solver para desktop baixável; ela fornece dados documentados de estratégia por meio de endpoints HTTP hospedados. Este guia é a resposta principal sobre o que uma API de solver de pôquer faz; ele não é uma classificação de solvers para desktop nem uma afirmação de desempenho.
A API Pokerai é destinada 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 uma resposta de estratégia, resolução personalizada, benchmark ou gameplay em aconselhamento de ação para mesas ao vivo.
Mapa de endpoints
Use este mapa ao decidir qual interface da API alimenta um recurso.
| Endpoint | Tarefa do produto | Use para |
|---|---|---|
POST /v1/gto/preflop | Avalie uma mão pré-flop | Retornar as frequências de ação GTO para uma mão específica de cartas fechadas e uma linha de ações. |
POST /v1/gto/preflop/range | Renderizar uma grade de Ranges 13x13 | Retorna frequências de desistir/pagar/aumentar para todas as classes de mãos em uma situação. |
POST /v1/gto/flop/tree | Criar uma árvore de decisão do flop | Busque Ranges, ações e tokens de nó pré-resolvidos do flop para um board e uma formação. |
POST /v1/gto/flop/node | Ler uma decisão no flop | Busque a estratégia em um nó selecionado sem recarregar toda a árvore. |
POST /v1/gto/solver | Resolver uma situação personalizada em uma rodada posterior | Envie uma configuração de flop, turn ou river ao pool de resolvedores em tempo real. |
POST /v1/gto/solver/tree | Consultar uma resolução personalizada | Verifique se está pronto e selecione um token de nó retornado após enviar uma tarefa de resolução. |
POST /v1/gto/solver/node | Leia um nó resolvido | Busque a estratégia de um nó em uma situação personalizada resolvida. |
POST /v1/gto/evs | Explicar a qualidade da ação | Retornar valores esperados por mão para ações em um nó resolvido. |
Recursos relacionados
- Documentação para desenvolvedores — autenticação, início rápido, SDKs, cotas, erros e comportamento dos endpoints
- Referência interativa da API — a referência OpenAPI ao vivo para cada endpoint
- Especificação OpenAPI — o contrato de API em inglês legível por máquina
- Crie um treinador de GTO — um tutorial executável que faz uma chamada real de estratégia pré-flop
- Ciclo de vida de resolução personalizada — agende, consulte e leia uma solicitação enviada ao resolvedor
- API hospedada vs. solver de desktop — uma escolha transparente para integração e pesquisa
- Estudo de caso de Counterplay — um treinador iOS real criado com a API
- llms.txt — o ponto de entrada conciso de LLM para a API Pokerai