← Todos os guias
Nesta página
  1. Início
  2. Guias
  3. Como consulto EVs de nós GTO com uma API?
Guia Estratégia GTO · 01/06 Apps de solver 11 min Avançado

Como consulto EVs de nós GTO com uma API?

Depois que uma situação do solver em tempo real estiver concluída e sua árvore puder ser consultada, solicite os arrays de EV para um nó, opcionalmente filtrados para uma mão.

Atualizado Mantido por Pokerai API

Resposta direta: chame POST /v1/gto/evs com um identificador solve de /v1/gto/solver e um node_id de /v1/gto/solver/tree. O array actions da resposta define a ordem do array de EV de cada mão em evs.

Fatos rápidos

Ponto de extremidadePOST /v1/gto/evs
Pré-requisitoUma resolução concluída e uma árvore do solver consultável; consulte /v1/gto/solver/tree primeiro.
Entrada obrigatóriasolve e node_id; hand opcionalmente filtra para uma mão.
RespostaArrays de actions e evs por mão. Cada array de EV é alinhado por índice com actions.
CotaA descrição pública do OpenAPI marca esta leitura como gratuita após a resolução de origem /v1/gto/solver.
AcessoUse a mesma superfície de API autenticada e as regras de propriedade do identificador do solver que na resolução concluída.

Quando usar isto

Use EVs de nó em ferramentas de treinamento offline, coaching, revisão de mãos, estudo ou pesquisa depois que um resultado do solver estiver disponível. Eles são úteis quando uma interface de explicação precisa comparar as ações disponíveis em um nó concluído sem agendar outra resolução.

Quando não usar isto

Não chame este endpoint antes que a árvore do solver possa ser consultada e não trate um array de EV como uma recomendação de ação em tempo real, garantia de desempenho ou uma definição de EV além do contrato de resposta público.

Solicitação mínima da API

Substitua o handle ocultado pelo handle retornado pela sua própria solicitação ao solver. Use um identificador de nó da árvore correspondente do solver. O campo opcional hand limita a resposta àquela mão.

curl -s https://pokerai.bet/v1/gto/evs \
  -H "Authorization: Bearer $POKERAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"solve":"eyJ0Ijoic2x2X3h4eXoi...(handle from /v1/gto/solver)","node_id":"root","hand":"2c2d"}'

Interpretação da resposta

{"node_id": "root", "task_id": "slv_srp_…", "player": 1, "round": "FLOP", "actions": ["CHECK", "BET 4.000000", "BET 97.000000"], "evs": {"2c2d": [-0.826359, -0.792223, -1.643411], "2c2h": […], …}}

Na forma de resposta do código da documentação pública, actions é [CHECK, BET 4.000000, BET 97.000000]. Para evs["2c2d"], o primeiro número corresponde a CHECK, o segundo a BET 4.000000 e o terceiro a BET 97.000000.

Mantenha ambos os arrays juntos em uma interface de explicação. O contrato da API descreve esses valores como EVs por mão e por ação em bb; ele não seleciona uma ação nem promete um resultado.

Cota e prontidão

Este endpoint é documentado como gratuito porque a solicitação de origem /v1/gto/solver é a resolução cobrada. Se a resolução não tiver convergido, a resposta 200 poderá ser { spot_status: computing }; continue consultando a árvore do solver até que ela possa ser consultada, em vez de presumir que os dados de EV estão prontos.

Erros

HTTPSignificadoO que fazer
400Dados de solicitação inválidos.Verifique solve, node_id e o hand opcional em relação ao esquema público.
401A autenticação está ausente ou é inválida.Envie uma chave de API válida e mantenha-a fora do código do navegador e dos logs.
403O identificador da resolução é inválido ou não é seu.Use o identificador autenticado da sua própria solicitação ao solver.
410A resolução expirou (TTL).Agende a situação novamente com /v1/gto/solver.

Apenas para 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 comparações de EV fora da automação de mesas ao vivo e não as transforme em um prompt de ação durante a mão.

Recursos relacionados