Usar la API de MVP Capping para tu propio análisis

La API te permite consultar los mismos datos que muestra el sitio: eventos, cuotas, pronósticos de modelos con sus resultados y su valor de la línea de cierre, e historiales de modelos. Es para tu propio análisis: reconstruir un historial a tu manera, cruzar pronósticos con datos que recoges tú o seguir estrategias en tus propias herramientas.

Es de solo lectura. No hay mutaciones ni webhooks, así que la consultas periódicamente para ver los cambios. Volver a publicar lo que devuelve requiere una licencia comercial, que la página para desarrolladores explica.

El acceso a la API está incluido en los planes Edge y Quant. Crea una clave personal en Cuenta, luego Acceso a la API, y envíala como token Bearer en la cabecera Authorization de un POST a /graphql. Mantén la clave fuera del código del navegador y de los repositorios públicos, y revócala si se filtra.

Cada plan tiene una cuota por minuto y otra por día, que figuran en la página para desarrolladores. Superarlas devuelve un 429 con una cabecera retry-after; espera ese tiempo en lugar de reintentar en bucle. Las consultas están limitadas a siete niveles de anidación, y la introspección está desactivada en producción, así que parte de los ejemplos documentados.

Consulta con una frecuencia acorde a la frecuencia con que cambian los datos. Los pronósticos y las cuotas cambian a lo largo del día. Los historiales finales cambian cuando se evalúa un partido. Preguntar cada pocos segundos por datos que cambian cada pocos minutos gasta cuota para nada.

Reconstruye tú mismo el historial de una estrategia. Descarga sus pronósticos evaluados y calcula victorias, derrotas, unidades y CLV medio a partir de las filas individuales. Compara tus totales con el tablero de Estrategias. Si coinciden, tienes un proceso que funciona y una comprobación de nuestra aritmética. Si no, averigua por qué antes de construir nada más grande.

Después ve más allá: divide el historial por rango de precio, por cuánto antes del inicio se publicó cada pronóstico o por día de la semana. Son preguntas que el tablero no responde, y la API es la forma de responderlas.

Una primera petición solo necesita una URL, una cabecera y una consulta. Haz un POST a https://mvpcapping.com/graphql con la cabecera Authorization: Bearer seguida de tu clave, y un cuerpo JSON cuyo campo query pida historiales de modelos, por ejemplo el nombre de cada modelo, su ganancia en unidades y su porcentaje de acierto. La página para desarrolladores tiene ejemplos listos para copiar en curl y JavaScript.

Empieza poco a poco, lee la forma de la respuesta y solo entonces amplía la consulta. Una petición que lo pide todo de una vez es más difícil de depurar y más propensa a chocar con el límite de profundidad.

Guarda cada respuesta con la hora en que la descargaste. Las cuotas y los pronósticos cambian, y un historial que reconstruyas más tarde necesita saber qué decían los datos en ese momento. Una tabla sencilla de pronósticos indexada por el identificador del pronóstico, con el precio, la línea, el resultado y el CLV, basta para la mayoría de los análisis.

Trata el precio publicado de un pronóstico como fijo una vez que lo tengas. La evaluación y el CLV llegan más tarde, cuando el partido se liquida y se captura la línea de cierre, así que actualiza esos campos en lugar de sobrescribir toda la fila.

La API devuelve lo que tenemos, incluidas sus lagunas. Un partido sin porcentajes de apuestas en nuestras fuentes tampoco los tiene en la API. Los pronósticos de modelos retirados de la vista pública no se devuelven, igual que en el sitio. Tenlo en cuenta en cualquier conclusión que saques.