← Todos os guias
Nesta página
  1. Início
  2. Guias
  3. Como obtenho uma estratégia pré-flop por meio de uma API?
Guia Estratégia GTO · 06/06 Ferramentas de Ranges 12 min Iniciante

Como obtenho uma estratégia pré-flop por meio de uma API?

Faça uma chamada POST /v1/gto/preflop com as duas cartas do Hero, a posição do Hero e cada ação pré-flop antes do Hero. Pokerai API determina a situação e retorna uma distribuição de estratégia em JSON para essa mão.

Atualizado Mantido por Pokerai API

Resposta direta: autentique-se com sua chave de API, envie hole_cards, positions.hero e a sequência completa de preflop_actions, e opcionalmente selecione preflop_version. Leia cada item em strategy como uma frequência, não como uma jogada recomendada.

Fatos rápidos

Ponto de extremidadePOST /v1/gto/preflop
Entrada obrigatóriahole_cards, positions.hero e preflop_actions
SaídaA situation derivada, a strategy[] mista e o uso atual da quota
CotaCada chamada consome 1 consulta geral pré-resolvida; ela não usa a cota de resolução em tempo real
Uso pretendidoTreinamento, estudo, coaching, revisão de mãos e pesquisa — nunca RTA com dinheiro real

Crie a solicitação de pré-flop

A linha de ações é explícita e ordenada. Comece com as postagens dos blinds, inclua cada desistência, pagamento e aumento antes do Hero e pare antes que o Hero aja. Não inclua o Hero em preflop_actions.

CampoO que enviar
hole_cardsExatamente duas cartas em uma única string sem separação, como "AhKh".
positions.heroA posição do Hero no conjunto atual de posições 6-max: SB, BB, UTG, MP, CO ou BTN.
preflop_actionsA sequência completa antes do Hero. Cada item contém position e action; as ações que não são desistência incluem o amount recém-investido em BB, não um total acumulado.
preflop_versionID opcional do conjunto de tabelas pré-flop. Omita-o para usar o padrão da plataforma ou use um ID retornado por GET /v1/gto/preflop/versions.

Solicitação curl mínima

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

Leia a resposta real

Esta resposta capturada corresponde à solicitação acima: Hero tem AhKh em MP enfrentando uma abertura de UTG. situation é derivado da linha de ações, e quota informa o uso mensal desta chave.

{"hole_cards": "AhKh", "situation": "Raise", "strategy": [{"action": "raise", "frequency": 1, "amount_bb": 9, "sizing_pot": 0.8}], "quota": {"used": 7, "limit": 100}}

Como funciona a frequência mista

Cada frequency é uma probabilidade de 0 a 1, e as frequências de ação para a mão normalmente somam aproximadamente 1. Algumas mãos são puras, como na resposta acima; outras são genuinamente mistas.

Por exemplo, uma resposta capturada para 9h9s em MP enfrentando uma abertura UTG de 2,5BB retornou desistir 0.254, pagar 0.106 e aumentar 0.64. Isso significa 25,4% desistir, 10,6% pagar e 64% aumentar. A API expõe a distribuição; ela não promete nem escolhe uma ação recomendada.

O que amount_bb significa

Para um aumento retornado, amount_bb é o valor absoluto até o qual aumentar, em big blinds. Não é o amount incremental usado no histórico de ações da solicitação.

Aumentos antes do HeroSituação derivadaamount_bb
0Abertura3
13-bet9
24-bet25
3 ou mais5-bet+100 com allin: true

Escolha preflop_version com segurança

O preflop_version opcional seleciona um conjunto de gráficos preflop, e a mesma situação pode ter frequências diferentes entre versões. O exemplo usa 6max_RC_100bb_200NL; omitir o campo seleciona o padrão da plataforma.

Considere GET /v1/gto/preflop/versions como o endpoint de descoberta autoritativo. Use um ID retornado por ele em vez de pressupor que os IDs, as profundidades de stack ou os formatos atuais sejam permanentes.

Cota e tentativas

Uma consulta preflop consome 1 cota geral de soluções pré-resolvidas. Os campos quota.used e quota.limit da resposta mostram o contador mensal atual dessa chave de API; o uso também está visível no console.

Não tente novamente uma solicitação com a cota esgotada. Aguarde a redefinição mensal ou altere a cota disponível; reserve a lógica de nova tentativa para falhas transitórias documentadas pela API.

Erros comuns

HTTPErroCausa e correção
400invalid_hole_cardsEnvie exatamente duas cartas válidas em hole_cards.
400invalid_positions / invalid_actionsUse uma posição de Hero documentada e uma sequência de ações completa e legal que comece com as postagens dos blinds.
400unsupported_preflop_versionAtualize GET /v1/gto/preflop/versions e informe um dos IDs retornados.
401missing_api_key / invalid_api_keyEnvie uma chave de API válida no cabeçalho Authorization: Bearer.
404no_solutionA situação solicitada não tem dados pré-resolvidos; verifique ou altere a situação em vez de repetir a tentativa sem alterações.
429quota_exceededA cota geral mensal está esgotada; uma nova tentativa imediata não ajudará.

Quando usar isto — e quando não usar

Use consultas de estratégia preflop em treinadores, ferramentas de estudo, fluxos de trabalho de coaching, filas de revisão de mãos, pesquisas e análise de agentes offline. Armazene as frequências retornadas com a versão e a situação de entrada para que uma revisão permaneça reproduzível.

Não use a API Pokerai para assistência em tempo real em mesas com dinheiro real e não transforme uma saída mista em uma alegação de que uma jogada é garantida ou recomendada. A assistência em tempo real em mesas com dinheiro real é proibida. Consulte os Termos.

Não use Pokerai API para assistência em tempo real em mesas com dinheiro real nem transforme uma saída mista em uma alegação de que uma jogada é garantida ou recomendada. RTA com dinheiro real é proibido pelos Termos.

Referência, SDK e próximos passos