¿Cómo proceso rangos de póker con una API?
Usa los endpoints de rango de PokerKit para convertir la notación documentada en combinaciones concretas, inspeccionar propiedades deterministas de los rangos o estimar la equidad de rangos con controles explícitos de Monte Carlo; usa los endpoints de rangos GTO cuando la tarea sea un flujo de trabajo documentado de rangos del solver.
POST /v1/pokerkit/range/expand para expandir la notación. Usa /range/value y /range/nut-advantage para un análisis determinista de rangos basado en las cartas comunitarias, y /range/equity-advantage cuando necesites una estimación de la cuota de equity mediante Monte Carlo. Para rangos derivados de solver, usa los contratos publicados /v1/gto/range, /v1/gto/flop/projected-range o /v1/gto/turn/projected-range.Datos rápidos
| Notación | Matrices de notación de rangos de PokerKit como ["AA", "KQs"]; expand devuelve combinaciones concretas de dos cartas. |
|---|---|
| Determinista | range/expand, range/value y range/nut-advantage no usan muestreo Monte Carlo. |
| Monte-Carlo | range/equity-advantage acepta los parámetros documentados sample_count y seed; una semilla permite un muestreo reproducible. |
| Cuota | Los endpoints de rango deterministas de PokerKit consumen 1 cuota general. range/equity-advantage consume 1 cuota de resolución. |
| Rangos GTO | Los endpoints de rangos GTO son flujos de trabajo de solver independientes. Consulta su esquema actual de solicitud y respuesta en la Referencia o en la instantánea de OpenAPI. |
| Límite de uso | Para entrenamiento, coaching, revisión de manos, estudio e investigación; no para asistencia en tiempo real con dinero real. |
Notación de rangos
Pase una matriz JSON de cadenas de notación. AA indica una clase de mano de pareja de bolsillo y KQs indica rey-reina del mismo palo; la respuesta de expansión enumera pares de cartas concretos. Conserve la notación, el tablero y el orden de los jugadores junto con su entrada de revisión almacenada para que el resultado siga siendo interpretable.
Solicitud y respuesta mínimas verificadas
Este ejemplo de código de la documentación pública llama a POST /v1/pokerkit/range/expand. Envíe su clave API en Authorization: Bearer $POKERAI_API_KEY y el tipo de contenido 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 matriz interna es un combo concreto de dos cartas. Esta respuesta explica la notación proporcionada; no es una recomendación de acción GTO.
Elija la operación de rango
| Necesidad | Punto de conexión público | Método |
|---|---|---|
| Expandir notación | POST /v1/pokerkit/range/expand | Expansión determinista de combos. |
| Crear un rango de valor en un tablero | POST /v1/pokerkit/range/value | Umbral determinista de categoría hecha mediante aggression o floor. |
| Comparar la proporción de nuts | POST /v1/pokerkit/range/nut-advantage | División determinista de la proporción de nuts por conteo de combos. |
| Comparar la proporción de equidad | POST /v1/pokerkit/range/equity-advantage | Estimación de Monte Carlo para dos rangos proporcionados; use sample_count y seed solo según la documentación. |
| Avanzar un rango del solver | POST /v1/gto/range, /flop/projected-range, o /turn/projected-range | Contratos de rango GTO publicados para el flujo de trabajo del solver indicado. |
Determinista frente a Monte Carlo
No etiquete el resultado de expand, value o nut-advantage como una simulación: esas operaciones son deterministas para la entrada proporcionada. equity-advantage es diferente: es Monte Carlo, por lo que su resultado es una estimación para los rangos y el tablero enviados. Una seed fija hace que el muestreo sea reproducible, no universalmente exacto; conserve el sample_count devuelto al presentar el resultado.
Cuota y errores
| Señal | Significado | Qué hacer |
|---|---|---|
| 401 | missing_api_key o invalid_api_key. | Envíe un encabezado de clave API válido; no lo exponga en los registros del cliente. |
| 429 | quota_exceeded cuando se agota el contador mensual aplicable. | Espere al restablecimiento o reduzca el trabajo; no vuelva a intentar una solicitud sin cambios. |
| 422 | La validación de la solicitud falló. | Consulte la Referencia actual o el esquema OpenAPI del endpoint y corrija el cuerpo. |
Consulte la documentación de cuotas y el panel para ver los contadores actuales. Los endpoints de rango GTO siguen su propio comportamiento de cuota documentado.
Solo para formación y revisión
Recursos relacionados
- Documentación para desarrolladores — autenticación, PokerKit, flujos de trabajo GTO y cuotas.
- Referencia de la API — esquemas actuales de operaciones de rango.
- Instantánea de OpenAPI — contrato en inglés legible por máquinas.
- Python SDK, TypeScript / JavaScript SDK, y servidor MCP — puntos de entrada oficiales de los paquetes.
- Guía de la API de equidad de póker — estimaciones de equidad para varios rangos.
- llms.txt — punto de entrada LLM conciso.