Utiliser l’API de MVP Capping pour vos analyses

L’API vous permet d’interroger les mêmes données que celles du site : les événements, les cotes, les pronostics des modèles avec leurs résultats et leur valeur de la ligne de clôture, et les bilans des modèles. Elle sert à vos propres analyses : reconstruire un bilan à votre façon, croiser les pronostics avec des données que vous recueillez, ou suivre des stratégies dans vos propres outils.

Elle est en lecture seule. Il n’y a ni mutations ni webhooks ; vous l’interrogez donc à intervalles pour voir les changements. Republier ce qu’elle renvoie exige une licence commerciale, que la page des développeurs explique.

L’accès à l’API est inclus dans les forfaits Edge et Quant. Créez une clé personnelle sous Compte, puis Accès API, et envoyez-la comme jeton Bearer dans l’en-tête Authorization d’une requête POST vers /graphql. Gardez la clé hors du code exécuté dans le navigateur et des dépôts publics, et révoquez-la si elle fuit.

Chaque forfait a un quota par minute et par jour, indiqué sur la page des développeurs. Un dépassement renvoie une erreur 429 avec un en-tête retry-after ; attendez ce délai plutôt que de relancer en boucle. Les requêtes sont limitées à sept niveaux d’imbrication, et l’introspection est désactivée en production ; partez donc des exemples documentés.

Interrogez l’API à un rythme qui correspond à la fréquence des changements. Les pronostics et les cotes changent au fil de la journée. Les bilans finaux changent une fois le match évalué. Demander toutes les quelques secondes des données qui changent toutes les quelques minutes gaspille votre quota.

Reconstruisez vous-même le bilan d’une stratégie. Récupérez ses pronostics évalués, puis calculez les victoires, les défaites, les unités et la CLV moyenne à partir des lignes individuelles. Comparez vos totaux avec le tableau Stratégies. S’ils concordent, vous avez une chaîne de traitement qui fonctionne et une vérification de nos calculs. Sinon, trouvez pourquoi avant de bâtir quoi que ce soit de plus gros.

Allez ensuite plus loin : découpez le bilan par tranche de prix, par délai entre la publication et le début du match, ou par jour de la semaine. Le tableau ne répond pas à ces questions, et l’API est le moyen d’y répondre.

Une première requête n’a besoin que d’une URL, d’un en-tête et d’une requête GraphQL. Envoyez un POST à https://mvpcapping.com/graphql avec l’en-tête Authorization: Bearer suivi de votre clé, et un corps JSON dont le champ query demande les bilans des modèles, par exemple le nom de chaque modèle, son profit en unités et son taux de réussite. La page des développeurs contient des exemples prêts à copier en curl et en JavaScript.

Commencez petit, lisez la forme de la réponse, et seulement ensuite élargissez la requête. Une requête qui demande tout d’un coup est plus difficile à déboguer et plus susceptible d’atteindre la limite d’imbrication.

Conservez chaque réponse avec l’heure à laquelle vous l’avez récupérée. Les cotes et les pronostics changent, et un bilan reconstruit plus tard doit savoir ce que disaient les données à ce moment. Une simple table de pronostics indexée par identifiant, avec le prix, la ligne, le résultat et la CLV, suffit pour la plupart des analyses.

Considérez le prix publié d’un pronostic comme fixe une fois que vous l’avez. L’évaluation et la CLV arrivent plus tard, quand le match est réglé et la ligne de clôture captée ; mettez donc ces champs à jour plutôt que d’écraser toute la ligne.

L’API renvoie ce que nous détenons, lacunes comprises. Un match sans répartitions dans nos sources n’en a pas non plus dans l’API. Les pronostics des modèles retirés de la vue publique ne sont pas renvoyés, comme sur le site. Notez-le dans toute conclusion que vous tirez.