Une petite forme de grille de données reliée par une ligne droite à une forme d'engrenage qui se tient seule à droite.

Bots de paris et API : automatiser sans faire fermer son compte

Le bot tourne à 3 heures du matin. Votre compte devrait toujours être là à 9 heures. Betfair trace une vraie ligne entre les deux façons d'y arriver, et ce n'est pas la ligne que décrivent la plupart des fils de forum.

Un bot de paris est tout script qui place ou gère des paris sans qu'un doigt touche la souris. Sur Betfair Exchange, le mot qui décide si c'est autorisé n'est pas « bot », c'est « API ». Les conditions de Betfair traitent un pari placé par d'autres moyens automatisés, autres que le titulaire du compte plaçant chaque pari manuellement, comme une activité suspecte, puis excluent explicitement l'API de cette clause. Une seconde règle rattrape aussi les utilisateurs de l'API : le compte doit rester personnel, pas un service géré pour quelqu'un d'autre. Avant tout cela, testez la logique sur les données différées de la clé Delayed et concevez le script autour des limites de l'API sur les requêtes, la concurrence et les connexions. Les clés elles-mêmes, et ce que disent les quatre brokers de leurs outils, ont leur propre page, plus bas.

Ce que la règle sépare vraiment

L'automatisation est une ligne parmi plusieurs dans l'ensemble plus large des méthodes de paris professionnels que ce site couvre, et elle a sa propre page parce que les règles ici sont plus précises que « les parieurs sharp utilisent des logiciels ». Le raccourci des forums traite « bot » comme une seule chose : un logiciel qui place des paris. Les conditions de Betfair sont plus précises. La clause 12.1.4 liste, parmi les activités qu'elle traite comme suspectes, un pari placé « autrement que par le titulaire du compte plaçant chaque pari manuellement », ce qui, lu seul, attraperait tout script jamais écrit. Ce n'est pas lu seul : la même clause porte sa propre exception, énoncée pour éviter toute ambiguïté, selon laquelle les paris placés « via l'interface de programmation applicative (API) » n'en font pas partie. Mettez les deux fragments ensemble et la séparation est exacte : un script qui clique sur le site web ordinaire est ce que vise la clause, et un script qui parle à l'API est l'exception que la clause se nomme à elle-même.

Remarque en passant : « bot » fait beaucoup de travail dans cette phrase, et le mot n'apparaît en réalité jamais dans la clause. Les juristes de Betfair ont plutôt écrit « autrement que par le titulaire du compte plaçant chaque pari manuellement », une façon plus longue de dire la même chose, mais une phrase bien plus difficile à citer de travers. Revenons à ce que cela signifie pour vous.

La règle n'est donc pas « les bots sont interdits » ni « les bots sont permis ». Elle est plus étroite : un script non officiel qui travaille le site web comme une paire de mains très rapide tombe dans une clause sur l'activité suspecte, tandis que la même logique branchée sur l'API officielle tombe dans l'exception. Quelqu'un qui fait du trading sur l'échelle à la main et un script qui fait la même chose via l'API sont traités différemment par le même document, et la différence est la porte, pas la stratégie derrière elle.

La ligne de l'usage personnel, et où un bot peut la franchir

Une deuxième clause compte tout autant et se lit bien moins souvent. Betfair peut traiter l'usage d'un compte comme interdit « si nous suspectons (en agissant raisonnablement) que l'usage de votre compte représente un "usage commercial" », défini délibérément de façon large : « l'"usage commercial" inclut tout usage par un opérateur de paris ou tout usage par une personne ou une organisation fournissant des données ou des services à un opérateur de paris » (clause 11.2.13). Cela n'a rien à voir avec l'exception de l'API ci-dessus. Un script peut se situer carrément dans l'exception de la clause 12.1.4 et quand même enfreindre la clause 11.2.13, s'il fait en réalité tourner des paris pour quelqu'un d'autre, alimente un service d'abonnement, ou sert de moteur à un produit vendu à d'autres parieurs.

Je traiterais les deux clauses comme répondant à des questions différentes. La clause 12.1.4 demande comment le pari a été placé. La clause 11.2.13 demande à qui appartenaient vraiment l'argent et la décision. Un bot qui n'agit jamais que sur le propre compte d'une seule personne répond par défaut à la deuxième question. Un bot qui gère les mises de plusieurs personnes, ou qui vend ses signaux, n'y répond pas, quelle que soit la porte qu'il utilise pour placer le pari.

Chaque voie d'accès à l'API part d'un compte vérifié. L'aide aux développeurs de Betfair le dit clairement : sans compte Betfair, « vous ne pouvez pas avancer dans la procédure de licence » du tout, et les vérifications d'identité que cela implique réellement passent avant toute clé. L'automatisation commerciale a sa propre voie séparée via le volet entreprises de Betfair, pas une clé personnelle avec un budget plus large.

L'API est la porte. Un script sur le site web ne l'est pas.

Ce qu'il faut tester avant de financer une clé Live

Tout le monde qui construit un bot veut passer directement au placement des paris. L'ordre honnête va dans l'autre sens : prouver la logique sur des données volontairement plus lentes que le temps réel, à la plus petite mise que le lieu de paris autorise, avant qu'une clé payante ou une bankroll sérieuse n'en soit proche.

Clé Delayed de Betfair : l'ancienneté possible des données de cote

Source : documentation pour développeurs de Betfair, FACTS-betfair.md section 6.

Données du graphique
ÉlémentValeur
Instantané le plus rapide1
Instantané le plus lent180

Cet écart, une seconde au mieux et jusqu'à trois minutes au pire, n'est pas une erreur d'arrondi à balayer d'un revers de main. Un prix qu'un script a vu pour la dernière fois comme raisonnable peut avoir largement bougé au moment où le script agit, et il n'existe aucun bac à sable pour adoucir cela : la documentation de Betfair elle-même indique qu'il n'existe aucun environnement de test permettant de tester sans utiliser de fonds réels. Chaque pari placé par une clé Delayed est un pari réel avec un résultat réel, ce qui explique pourquoi la plus petite mise que le lieu de paris autorise est la seule façon raisonnable de faire tourner cette étape.

Une hypothèse, avec chaque chiffre inventé pour le seul calcul. Disons qu'un script surveille une cote à 2,10, décide de faire un back dessus, et que l'API lui renvoie un instantané vieux de 180 secondes à cet instant précis. Un but, un carton rouge ou un forfait de dernière minute peuvent survenir en trois minutes, si bien que la cote que le script croit backer et la cote réellement offerte au moment où l'ordre arrive peuvent être deux chiffres différents. Aucune logique astucieuse en amont ne répare une décision construite sur une information périmée ; le délai lui-même, pas la stratégie posée dessus, est la première chose qui vaut la peine d'être testée.

Le lieu de paris n'est que la moitié du tableau ; l'autre moitié est le flux auquel un bot réagit réellement, et un script construit sur un historique trop mince se trompera quelle que soit la clé sur laquelle il tourne. Vérifiez le calcul à la main sur une calculatrice avant de faire confiance aux propres chiffres d'un script, et rappelez-vous que la commission de l'exchange se prélève toujours sur tout pari gagnant ; ce que cela fait aux chiffres nets d'un bot vaut la lecture avant qu'une stratégie ne soit jugée gagnante sur le papier.

Une rangée de petits bras mécaniques au-dessus d'un bulletin de paris, tous à l'arrêt en plein mouvement sauf un.
La plus grande partie d'un bot attend. La partie qui agit est celle que les règles surveillent.

Les limites autour desquelles un script doit être conçu

Rien de tout cela ne concerne la question de savoir si l'automatisation est autorisée. Il s'agit du plafond que l'API elle-même impose sur le comportement d'un script, énoncé en chiffres clairs plutôt que laissé au hasard. Quatre d'entre eux comptent le plus quand un script est encore sur la planche à dessin, et, avec la fenêtre de délai de la clé Delayed vue plus haut, ce sont des chiffres que Betfair peut réviser ; vérifiez les conditions actuelles avant de concevoir du code de production autour de l'un d'eux.

  • Un plafond de 200 points sur les requêtes de données de marché. Le coût s'additionne sur l'ensemble des marchés et le type de données demandé ; dépasser le total renvoie une erreur plutôt que les données.
  • Un plafond de 3 requêtes simultanées sur les appels d'ordres et de position. Vérifier les ordres en cours, les profits et pertes, ou les ordres réglés plus de trois fois à la fois, pendant que des appels antérieurs tournent encore, est refusé plutôt que mis en file d'attente.
  • Un plafond de 1 000 instructions par seconde pour placer, annuler, modifier ou remplacer des ordres. Cela couvre tout le compte sur l'ensemble des connexions ouvertes, pas un seul script isolé.
  • Un blocage de 20 minutes après trop d'échecs de connexion. Toute nouvelle tentative de connexion est automatiquement refusée pendant cette période, quelle que soit la cause des échecs précédents.

Une seconde hypothèse, celle qui piège vraiment les gens. Un script dont la gestion de connexion contient un bug ne rafraîchit pas sa session à temps et retente en boucle serrée plutôt que de ralentir. Vingt minutes, c'est à peu près une mi-temps de football ; déclencher le blocage au coup d'envoi fait manquer au script plus de match qu'il n'en a jamais capté. La solution est plus terne que l'histoire : tenir la session, et traiter un échec de connexion comme une raison de s'arrêter, pas de retenter immédiatement.

Où les propres conditions d'un broker ajoutent une couche supplémentaire

Tout ce qui précède est le règlement propre à Betfair, et il ne s'applique qu'à un compte Betfair détenu directement. L'outil d'exchange d'un broker est un produit différent, ouvert chez le broker, pas chez Betfair, donc les clauses de l'API de Betfair ne s'y appliquent pas automatiquement. Ce qui compte à la place, ce sont les propres conditions de chaque broker, et elles ne disent pas toutes la même chose sur les scripts : certains publient leur propre API, d'autres interdisent purement et simplement l'accès automatisé. Traitez la clause anti-scraping d'un broker comme sa propre règle maison à respecter et à signaler si elle change, jamais comme quelque chose à contourner. Ce que dit déjà chaque broker sur les bots détaille cela broker par broker, avec le coût des clés ; cette page ne le répétera pas.

Si construire et maintenir un script n'est pas vraiment le projet recherché, les brokers en intègrent déjà une partie : l'automatisation déjà intégrée chez un broker couvre ce qui vient prêt à l'emploi, sans code à écrire. Un compte signalé pour activité suspecte au titre de la clause 12.1.4, automatisé ou non, n'est pas non plus ignoré discrètement ; à quoi ressemble vraiment une restriction de compte couvre cet aspect.

Je ne construirais rien avant d'avoir lu les conditions actuelles du broker précis, pas un résumé de forum. Les conditions des quatre brokers comparées côte à côte est la façon la plus rapide de voir où l'automatisation est bienvenue, où elle reste silencieuse, et où elle est purement interdite.

Questions fréquentes

Utiliser un bot de paris sur Betfair Exchange est-il contraire aux règles ?

Pas automatiquement. Les conditions de Betfair traitent un pari placé par d'autres moyens automatisés, hors le titulaire du compte plaçant chaque pari manuellement, comme une activité suspecte, puis excluent explicitement de cette même clause les paris placés via l'API officielle. Un script qui passe par l'API se trouve dans l'exception ; un script qui travaille le site web ordinaire comme des mains très rapides n'y est pas.

Un bot de paris peut-il tourner pour quelqu'un d'autre, ou dans un cadre commercial ?

Cela franchit une autre ligne. Betfair peut traiter un compte comme interdit s'il suspecte raisonnablement que l'usage constitue un usage commercial, défini pour inclure l'usage par un opérateur de paris ou par quiconque fournit des données ou des services à l'un d'eux. Un compte personnel est destiné aux propres paris de son titulaire, automatisés ou non.

Quelle est la vraie différence entre un bot de paris et l'API Betfair ?

« Bot » est un raccourci pour désigner le logiciel ; l'API est le canal précis et sanctionné que Betfair a construit pour l'accès automatisé. Les conditions ne jugent pas un logiciel sur l'étiquette qu'on lui colle, seulement sur le canal qui a placé le pari.

Un bot de paris peut-il être testé sans risquer de l'argent réel ?

Pas avec la clé Delayed, l'option de développement gratuite : Betfair indique qu'il n'existe aucun environnement de test permettant de tester sans utiliser de fonds réels, donc chaque pari qu'elle place est un pari réel avec un résultat réel, à garder de préférence à la plus petite mise tant que la logique est encore en cours de validation.

À quelle vitesse un bot de paris peut-il placer des ordres avant que l'API ne le ralentisse ?

Les plafonds fixés par Betfair sont un plafond de 200 points sur la quantité de données de marché qu'une requête peut demander, une limite de 3 requêtes simultanées sur les appels d'ordres et de position, et un plafond de 1 000 instructions d'ordre sur l'ensemble du compte en une seule seconde. Trop d'échecs de connexion ajoutent un blocage de 20 minutes en plus. Vérifiez la documentation actuelle avant de vous appuyer sur l'un de ces chiffres pour du code de production.

Les brokers de paris sportifs de ce site autorisent-ils les bots de paris ?

Cela varie selon le broker, et cette page ne répétera pas le détail ; la page qui couvre la position de chaque broker sur les API et l'automatisation le donne broker par broker, avec le coût des clés Betfair.