← Todas las guías
En esta página
  1. Inicio
  2. Guías
  3. ¿Cómo calculo el ICM de un torneo con la API de PokerKit?
Guía Semántica del póker · 06/09 Herramientas para torneos 9 min Intermedio

¿Cómo calculo el ICM de un torneo con la API de PokerKit?

Envía los premios del torneo y las pilas de fichas ordenados a POST /v1/pokerkit/icm para recibir valores de equidad ICM en el mismo orden de jugadores.

Actualizado Mantenido por Pokerai API

Respuesta directa: envía matrices correspondientes de payouts y chips. En la respuesta documentada, cada valor de result.icm se corresponde, por posición en la matriz, con el montón de fichas enviado por ese jugador y la estructura de premios del torneo.

Datos rápidos

Punto de conexiónPOST /v1/pokerkit/icm
Datos de entrada obligatoriospayouts y chips, ambas matrices numéricas en el esquema OpenAPI público
RespuestaUn objeto result con una matriz numérica icm
Límite de usoCálculo de equidad de torneos para entrenamiento, coaching, revisión de manos, estudio e investigación; sin asistencia en tiempo real con dinero real (RTA)

Semántica de entrada

chips proporciona los montones de fichas del torneo, y payouts proporciona los valores de pago. Ambos campos son obligatorios según el esquema público IcmRequest. Mantén estable el orden de los jugadores: la respuesta documentada devuelve un arreglo icm, por lo que sus posiciones se interpretan en relación con las posiciones de chips enviadas.

Solicitud y respuesta mínimas

Usa JSON y una clave de API. Esta solicitud y respuesta son el ejemplo de código de documentación pública de pokerkitIcm.

curl -s https://pokerai.bet/v1/pokerkit/icm \
  -H "Authorization: Bearer $POKERAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"payouts":[50,30,20],"chips":[5000,3000,2000]}'
{"result":{"icm":[38.392857142857146,32.75,28.857142857142854]}}

Interpretación de la equidad ICM

En el ejemplo, el primer montón enviado, 5000, se corresponde con el primer valor de ICM devuelto, 38.392857142857146; la segunda y la tercera posición se corresponden del mismo modo. Trata esos valores como la salida de equidad ICM del punto de conexión para esta entrada de pagos y montones. No los renombres como cantidades de fichas, una probabilidad de ganar, una estrategia de solver o una acción de póker recomendada.

Alcance y uso

Usa este endpoint cuando un flujo de trabajo de entrenamiento de torneos, coaching o revisión de manos completadas necesite un cálculo de equity ICM a partir de una estructura de premios y conjunto de stacks indicados. No proporciona rangos de manos, cartas, acciones de apuestas, estrategia de torneos ni una recomendación durante la partida. Mantenlo fuera de la asistencia para decisiones en vivo con dinero real.

Cuota y errores

Este endpoint utiliza la misma clave de API y el mismo sistema de cuota de cuenta que la API pública de PokerKit. Consulta la documentación sobre cuotas, los precios y el panel para conocer los límites actuales de la cuenta, en lugar de codificar un límite de forma fija.

El contrato público de OpenAPI declara una respuesta de error de validación 422. Comprueba que ambos arreglos obligatorios se ajusten al esquema actual de la Referencia u OpenAPI antes de corregir y volver a enviar una solicitud. Para la autenticación y la gestión de la cuota de la cuenta, usa la documentación de errores actual; no reintentes una solicitud inválida sin cambios.

Sin RTA con dinero real

Pokerai API es solo para entrenamiento, coaching, revisión de manos, estudio e investigación. Se prohíbe la asistencia en tiempo real en mesas con dinero real. No conviertas la salida de ICM en una instrucción de acción en mesa en vivo ni en una señal de automatización.

Recursos relacionados

Utiliza los contratos públicos actuales y la documentación de la cuenta junto con esta guía.

RecursoQué cubreÚsalo para
POST /v1/pokerkit/icmCálculo de la equidad ICM a partir de payouts y chipsInspeccionar el contrato público actual de solicitud y respuesta

SDK, MCP y recursos relacionados