Como faço minha primeira solicitação à API de poker GTO?

Fatos rápidos

Quando usar este guia de início rápido

Use-o para verificar a autenticação, inspecionar o formato da resposta ou iniciar um treinador, uma ferramenta de estudo, um fluxo de revisão de mãos, um serviço de backend ou uma integração de agente de IA.

Quando não usá-lo

Não use este endpoint como aconselhamento ao vivo durante jogo com dinheiro real. Para uma árvore personalizada de flop, turn ou river, siga o fluxo de trabalho de resolução em tempo real na documentação para desenvolvedores em vez de tratar esta consulta pré-flop como um solver pós-flop geral.

Solicitação curl mínima

Crie uma chave, armazene-a localmente como POKERAI_API_KEY e execute esta solicitação. Nunca faça commit da chave real nem a coloque em código do lado do cliente.

curl -s https://pokerai.bet/v1/gto/preflop \
  -H "Authorization: Bearer $POKERAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "hole_cards": "9h9s",
    "positions": { "hero": "MP" },
    "preflop_actions": [
      { "position": "SB", "action": "small blind", "amount": 0.5 },
      { "position": "BB", "action": "big blind", "amount": 1 },
      { "position": "UTG", "action": "raise", "amount": 2.5 }
    ]
  }'

Resposta real

Esta resposta capturada é para MP segurando 9h9s após uma abertura UTG de 2,5bb:

{
  "hole_cards": "9h9s",
  "situation": "Raise",
  "strategy": [
    { "action": "fold", "frequency": 0.254 },
    { "action": "call", "frequency": 0.106 },
    { "action": "raise", "frequency": 0.64, "amount_bb": 9, "sizing_pot": 1 }
  ]
}

As três frequências somam 1: desistir 25,4%, pagar 10,6% e aumentar para 9bb 64%. Trate isso como uma distribuição para estudar ou amostrar, não como uma promessa de que uma ação vencerá.

Cota

A API Pokerai contabiliza consultas pré-resolvidas separadamente das resoluções em tempo real. Esta solicitação de pré-flop usa uma consulta pré-resolvida. O plano Free inclui 1.000 consultas pré-resolvidas e 25 resoluções em tempo real por mês; ambos os contadores são redefinidos mensalmente, e o uso atual é exibido no painel. Consulte preços para conhecer os limites públicos atuais.

Erros comuns

O contrato OpenAPI público deste endpoint declara estas respostas sem sucesso:

Opções de SDK e MCP

Os clientes oficiais seguem o mesmo contrato OpenAPI público e usam a mesma chave de API e cota. Exemplos completos e tipados estão na documentação do SDK.

• SDK Python: pip install pokerai-bet (importe como pokerai).
• SDK TypeScript / JavaScript: npm install @pokerai/client.
• Servidor MCP para agentes de IA: npx @pokerai/mcp. As ferramentas pré-resolvidas são habilitadas por padrão; habilitar as ferramentas do solver consome a cota separada de resoluções.

Sem RTA com dinheiro real