¿Cómo calculo la equidad de póker con Pokerai API?
Envía dos o más rangos de jugadores al endpoint público de equidad de PokerKit; añade un board, el número de muestras y una semilla solo cuando tu caso de uso los necesite.
POST /v1/pokerkit/equity con el array ranges obligatorio. Es un cálculo de equidad Monte-Carlo, no una recomendación de GTO ni un asistente de juego en tiempo real.Datos rápidos
| Dato | Valor |
|---|---|
| Operación | POST /v1/pokerkit/equity |
| Parámetro obligatorio | ranges: matrices de notación de rangos por jugador. |
| Parámetros opcionales | board (el valor predeterminado es una cadena vacía), sample_count y seed. |
| Método | Montecarlo; la descripción de OpenAPI indica que sample_count tiene un límite y que un valor sin establecer usa el predeterminado. |
| Reproducibilidad | seed es el parámetro de solicitud público para un muestreo reproducible. |
Solicitud mínima de la API
curl -s https://pokerai.bet/v1/pokerkit/equity \
-H "Authorization: Bearer $POKERAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"ranges":[["AA","KK"],["QQ","JJ"]]}'El esquema público EquityRequest solo requiere ranges. Añade board para un board conocido y sample_count o seed solo cuando se necesiten los controles de muestreo documentados.
Cómo interpretar la respuesta
Una respuesta correcta está documentada como HTTP 200. La instantánea pública de OpenAPI deja intencionadamente abierto su esquema de respuesta, por lo que el código cliente debe inspeccionar el JSON devuelto y evitar asumir campos no documentados o una única acción recomendada. La equidad describe los rangos y las cartas enviados; no proporciona estrategia GTO.
Errores, límites y uso seguro
| HTTP | Contrato público | Qué hacer |
|---|---|---|
| 422 | HTTPValidationError | Comprueba la forma obligatoria de ranges y los tipos de los parámetros proporcionados. |
| Muestreo | sample_count tiene un límite | No supongas que se usará un valor enviado mayor; utiliza la respuesta de la API y la referencia para conocer el comportamiento actual. |
Usa este endpoint para entrenamiento, coaching, revisión de manos, estudio e investigación. Se prohíbe la asistencia en tiempo real para juegos con dinero real (RTA). Esta página no publica permisos específicos de cada plan ni promete asistencia en mesas en vivo.
Documentación relacionada
- Centro de documentación — descripción general de PokerKit y de la API GTO.
- Equidad ICM — cálculos deterministas de pagos y fichas, distintos de la equidad de rangos.
- Referencia de la API — formulario de solicitud a nivel de operación y detalles actuales de la respuesta.
- Instantánea de OpenAPI — el contrato público de
EquityRequest.
Real-time assistance at real-money tables is prohibited.