¿Cómo calculo la equidad de rangos de póker con una API?

Envíe el rango de cada jugador, un tablero opcional y controles reproducibles de Monte Carlo al endpoint de equidad de PokerKit; use las participaciones devueltas para explicar un escenario proporcionado, no para predecir un resultado.

Actualizado 26 de julio de 2026Mantenido por Pokerai API

Respuesta directa: llame a POST /v1/pokerkit/equity con ranges, que contiene una matriz de notación de rangos por jugador. Opcionalmente, incluya un tablero, sample_count y seed. La respuesta devuelve una equidad Monte Carlo por cada rango proporcionado, además del número de muestras utilizado.

Datos rápidos

Punto de conexión	`POST /v1/pokerkit/equity`
Entrada	Dos o más rangos, uno por jugador, en la notación de rangos de PokerKit; `board` es opcional.
Método	Estimación de equidad mediante Monte-Carlo. Devuelve una estimación para los rangos y el tablero proporcionados, no una garantía de probabilidades.
Respuesta	`result.equities` está ordenado para coincidir con `ranges`; `result.sample_count` informa del contexto de muestreo.
Cuota	Este endpoint consume 1 cuota de resolución. El nivel Free actual incluye 25 resoluciones en tiempo real al mes.
Acceso	Los endpoints de PokerKit y GTO usan la misma clave de API. Envíe una cabecera de clave de API compatible.

Semántica de entrada

Use un arreglo de rangos anidado para cada jugador. El orden de los arreglos es importante porque las equidades devueltas usan el mismo orden. Un tablero, cuando se proporciona, es una cadena de cartas sin separadores como AhKhQh.

Campo	Significado
`ranges`	Obligatorio. Arreglos por jugador de cadenas en notación de rango, por ejemplo `[["AA"], ["KK"]]`.
`board`	Cadena de cartas opcional para el tablero conocido; omítala o use una cadena vacía cuando no se conozca ningún tablero.
`sample_count`	Recuento opcional de muestras de Monte-Carlo. Se aplica el límite documentado del servicio; se usa el valor predeterminado cuando no se especifica.
`seed`	Semilla opcional para un muestreo reproducible.

Solicitud mínima a la API

Este ejemplo de código de la documentación pública compara AA y KK antes del flop, con un número fijo de muestras y una semilla. Añade tu clave de API como cabecera de autenticación al realizar la solicitud HTTP.

{"ranges": [["AA"], ["KK"]], "board": "", "sample_count": 2000, "seed": 7}

Ejemplo de respuesta e interpretación

{"result": {"equities": [0.8235, 0.1765], "sample_count": 2000}}

El primer valor, 0.8235, corresponde al primer rango de entrada (AA); el segundo, 0.1765, corresponde a KK. Conserva este orden en tu interfaz de usuario o informe.

Interprete sample_count: 2000 como el número de muestras de Monte Carlo utilizadas para esta respuesta. Describe el contexto de muestreo de esta estimación; no es una promesa sobre un reparto futuro, una apuesta ni el rendimiento.

Cuándo usar esto

Usa el endpoint en productos de entrenamiento, revisión de manos completadas, herramientas de coaching, investigación o una interfaz de explicaciones donde los rangos y las cartas comunitarias se muestran explícitamente al usuario. Guarda las entradas proporcionadas junto al resultado para que la estimación siga siendo auditable.

Cuándo no usar esto

No uses una estimación de equidad como indicación de acción durante una mano con dinero real; no sustituye el criterio del jugador, un modelo de juego completo ni una estrategia de solver. No des a entender que una estimación garantiza una victoria, una carta futura o un resultado de apuesta.

Cuota y autenticación

Envía Authorization: Bearer $POKERAI_API_KEY (o el equivalente X-API-Key) con la solicitud. El endpoint consume 1 cuota de resolución; el nivel Free actual tiene 25 resoluciones en tiempo real por mes. Consulta el uso actual en el panel y lee el tema de cuotas antes de diseñar trabajo por lotes.

Errores

HTTP	Significado	Qué hacer
401	`missing_api_key` o `invalid_api_key`.	Envía un encabezado de clave API válido y mantén la clave fuera de los registros del cliente.
Cuota	`quota_exceeded` cuando se haya agotado la cuota mensual aplicable.	Espera al reinicio mensual o ajusta la carga de trabajo; no vuelvas a intentar solicitudes sin cambios.
422	La validación de la solicitud falló, por ejemplo, debido a una estructura de cuerpo no válida.	Consulta la Referencia actual o el esquema OpenAPI y corrige la entrada.

Solo para entrenamiento y revisión

Usa Pokerai API para formación, entrenamiento, revisión de manos, estudio e investigación. Se prohíbe la asistencia en tiempo real en mesas con dinero real. Mantén las visualizaciones de equity fuera de la automatización de mesas en vivo y no las conviertas en una recomendación de acción.

Recursos relacionados

Documentación para desarrolladores — autenticación, comportamiento de las cuotas, SDKs y conceptos de API
Guía de cuotas — los límites actuales de Free y el manejo de errores de cuota
Referencia interactiva de la API — el esquema actual de la operación de equity
Especificación de OpenAPI — el contrato en inglés legible por máquinas
SDK de Python — el paquete oficial de Python
TypeScript / JavaScript SDK — el cliente oficial de npm
Servidor MCP oficial — el paquete MCP documentado para flujos de trabajo de agentes
Guía de la API de revisión de manos de póker — integra equity en un flujo de trabajo de revisión posterior a la sesión
llms.txt — el punto de entrada conciso de LLM para Pokerai API