Como processar Ranges de poker com uma API?
Use os endpoints de Ranges do PokerKit para transformar a notação documentada em combos concretos, inspecionar propriedades determinísticas de Ranges ou estimar a equidade de Ranges com controles explícitos de Monte Carlo; use os endpoints de Ranges GTO quando a tarefa for um fluxo de trabalho documentado de Ranges do solver.
POST /v1/pokerkit/range/expand para expandir a notação. Use /range/value e /range/nut-advantage para análise determinística de Ranges baseada no board e /range/equity-advantage quando precisar de uma estimativa de participação de equidade por Monte Carlo. Para Ranges derivadas do solver, use os contratos publicados /v1/gto/range, /v1/gto/flop/projected-range ou /v1/gto/turn/projected-range.Fatos rápidos
| Notação | Arrays de notação de Ranges do PokerKit, como ["AA", "KQs"]; expand retorna combinações concretas de duas cartas. |
|---|---|
| Determinístico | range/expand, range/value e range/nut-advantage não usam amostragem Monte Carlo. |
| Monte-Carlo | range/equity-advantage aceita os parâmetros documentados sample_count e seed; uma seed permite amostragem reproduzível. |
| Cota | Os endpoints determinísticos de Ranges do PokerKit consomem 1 cota geral. range/equity-advantage consome 1 cota de resolução. |
| Ranges GTO | Os endpoints de Ranges GTO são fluxos de trabalho de solver separados. Consulte o esquema atual de solicitação e resposta na Referência ou no snapshot OpenAPI. |
| Limite de uso | Para treinamento, coaching, revisão de mãos, estudo e pesquisa; não para assistência em tempo real com dinheiro real. |
Notação de Range
Passe um array JSON de strings de notação. AA denota uma classe de mão de par de bolso e KQs denota rei-dama suited; a resposta de expand lista pares de cartas concretos. Mantenha a notação, o board e a ordem dos jogadores junto da entrada de revisão armazenada para que o resultado permaneça interpretável.
Solicitação e resposta mínimas verificadas
Este exemplo público de código da documentação chama POST /v1/pokerkit/range/expand. Envie sua chave de API em Authorization: Bearer $POKERAI_API_KEY e o tipo de conteúdo JSON.
{"notation": ["AA", "KQs"]}{"result": [["Ac", "Ad"], ["Ac", "Ah"], ["Ac", "As"], ["Ad", "Ah"], ["Ad", "As"], ["Ah", "As"], ["Kc", "Qc"], ["Kd", "Qd"], ["Kh", "Qh"], ["Ks", "Qs"]]}Cada array interno representa uma combinação concreta de duas cartas. Esta resposta explica a notação fornecida; não é uma recomendação de ação GTO.
Escolha a operação de Range
| Necessidade | Endpoint público | Método |
|---|---|---|
| Expandir notação | POST /v1/pokerkit/range/expand | Expansão determinística de combos. |
| Criar um Range de valor em um board | POST /v1/pokerkit/range/value | Limite mínimo determinístico por categoria de mão feita usando aggression ou floor. |
| Comparar parcela de nuts | POST /v1/pokerkit/range/nut-advantage | Divisão determinística da parcela de nuts pela contagem de combos. |
| Comparar parcela de equity | POST /v1/pokerkit/range/equity-advantage | Estimativa de Monte Carlo para dois Ranges fornecidos; use sample_count e seed somente conforme documentado. |
| Avançar um Range do solver | POST /v1/gto/range, /flop/projected-range, ou /turn/projected-range | Contratos de Range GTO publicados para o fluxo do solver indicado. |
Determinístico versus Monte Carlo
Não rotule um resultado de expand, value ou nut-advantage como simulação: essas operações são determinísticas para a entrada fornecida. equity-advantage é diferente: usa Monte Carlo, portanto seu resultado é uma estimativa para os Ranges e o board enviados. Um seed fixo torna a amostragem reproduzível, não universalmente exata; mantenha o sample_count retornado ao apresentar o resultado.
Cota e erros
| Sinal | Significado | O que fazer |
|---|---|---|
| 401 | missing_api_key ou invalid_api_key. | Envie um cabeçalho de chave de API válido; não a exponha nos logs do cliente. |
| 429 | quota_exceeded quando o contador mensal aplicável estiver esgotado. | Aguarde a redefinição ou reduza o trabalho; não tente novamente uma solicitação inalterada. |
| 422 | A validação da solicitação falhou. | Verifique a Referência ou o esquema OpenAPI atual do endpoint e corrija o corpo. |
Consulte a documentação de cotas e o dashboard para ver os contadores atuais. Os endpoints de Range GTO seguem seu próprio comportamento de cota documentado.
Somente treinamento e revisão
Recursos relacionados
- Documentação para desenvolvedores — autenticação, PokerKit, fluxos GTO e cotas.
- Referência da API — esquemas atuais das operações de Range.
- Snapshot OpenAPI — contrato em inglês legível por máquina.
- SDK Python, SDK TypeScript / JavaScript e servidor MCP — pontos de entrada dos pacotes oficiais.
- Guia da API de equity de poker — estimativas de equity para vários Ranges.
- llms.txt — ponto de entrada conciso para LLM.