Ce package R fournit quelques fonctions simples pour permettre l'interaction avec le service API RESTful Matchbook.com. Veuillez lire attentivement la documentation de chaque fonction individuelle avant utilisation. Un compte Matchbook.com enregistré est requis pour utiliser ce package. Veuillez lire entièrement la documentation avant utilisation.
Pour installer le package, il faut la bibliothèque devtools :
library(devtools)
install_github("xanadunf/matchbook")
Les deux fonctions suivantes facilitent la vérification de la session du compte
Les fonctions suivantes permettent d'obtenir des informations sur les sports disponibles. Cela fournit les identifiants que Matchbook utilise pour chaque sport. Avec ceux-ci, vous pouvez obtenir tous les événements pour les sports qui vous intéressent. Par la suite, vous pouvez obtenir des identifiants de marché et des identifiants de coureur pour n'importe quelle liste d'identifiants d'événement. Consultez la documentation R pour plus de détails à ce sujet.
I La fonction suivante peut être utilisée pour obtenir des détails sur les paris qui ont été placés mais qui n'ont pas encore été réglés. Les détails des paris inégalés et correspondants peuvent être obtenus. Voir la documentation R pour plus de détails (par exemple ? mb_get_bets)
Les fonctions suivantes fournissent la fonctionnalité de base des paris.
Afin d'obtenir des détails sur les paris réglés, la fonction suivante peut être utilisée. Encore une fois, les paramètres complets de la fonction peuvent être consultés dans la documentation R (?mb_get_settled)
Cela devrait vous aider à être opérationnel dans un délai très court, en supposant que vous remplissiez les conditions préalables. Fixons-nous comme objectif dans ce didacticiel de parier sur le premier match de football que nous trouvons et qui contient le nom « homme ». Nous placerons un back pari de 5 EUR (ou quelle que soit la devise de votre compte) sur l'équipe locale pour remporter le match avec une cote de 1,10.
Pour commencer, vous devez vous connecter avec les informations d'identification de votre compte Matchbook.com.
library(devtools)
install_github("xanadunf/matchbook")
library(matchbook)
username <- "my_user_name" ### replace with your username
password <- "verysafepassword" ### replace with your password
session_details <- mb_login(username,password)
Puisque nous parions sur le football, nous devons connaître l’identité de ce sport.
sport_id_data <- mb_get_sports(session_details)
sport_id_data
football_sport_id <- sport_id_data$id[which(sport_id_data$name=="Soccer")]
football_sport_id
D’après les résultats, nous pouvons voir que le football a un identifiant sportif = 15. Nous pouvons l'utiliser pour obtenir n'importe quel événement de football avec une équipe contenant la chaîne « homme ».
event_data <- mb_get_events(session_data=session_details,sport_ids=football_sport_id)
event_data[grep(tolower("man"), tolower(event_data$name)),]
test_event_id <- event_data$id[grep(tolower("man"), tolower(event_data$name))[1]]
test_event_id
Évidemment, selon le moment où vous exécutez cette opération, vous pouvez obtenir beaucoup de résultats, voire aucun. Si vous ne trouvez pas de résultat positif, échangez « homme » contre le nom d'une équipe de football dont vous savez qu'elle jouera bientôt. Obtenons donc toutes les données de marché pour cet événement. Puisque nous voulons parier sur le résultat du match, nous allons essayer d'extraire le type de marché « gagnant unique -gagnant ».
market_data <- mb_get_markets(session_data=session_details,event_id=test_event_id,include_runners=TRUE)
market_data
test_market_id <- market_data$id[market_data$'market-type'=="one_x_two"]
test_market_id
Maintenant que nous avons le bon marché, obtenons des informations pour tous les coureurs de ce marché. Cette fois, nous incluons le paramètre 'include_prices=TRUE' afin que nous puissions voir à quel prix chaque coureur est disponible. Sélectionnons également le coureur à partir des données résultantes.
runner_data <- mb_get_runners(session_data=session_details,event_id=test_event_id,market_id=test_market_id,include_prices=TRUE)
runner_data
test_runner_id <- runner_data$id[grep("man", runner_data$name,ignore.case=TRUE)]
test_runner_id
Maintenant que nous avons des détails sur tous les coureurs, obtenons des détails sur les prix du coureur que nous avons sélectionné.
prices_data <- runner_data$prices[[which(runner_data$id==test_runner_id)]]
prices_data_back <- prices_data[prices_data$side=="back",]
best_available_current_price <- min(prices_data_back$'decimal-odds') # min because we are backing, use the max if you are laying.
Maintenant que nous avons trouvé les niveaux de prix sur lesquels nous pouvons revenir (le volume est également disponible via 'prices_data_back$'available-amount''), nous pouvons parier sur le coureur que nous avons sélectionné.
mb_bet_place(session_data=session_details,runner_id=test_runner_id,side='back',stake=5,odds=1.10)
mb_get_bets(session_data=session_details)
Lorsque le pari est placé, il est important d’examiner le statut du pari. Si le statut est « correspondant », alors vous avez été jumelé au prix fourni. S'il est « ouvert », cela signifie que le pari n'a pas été entièrement égalé. Pour plus de détails sur les paris placés, consultez la documentation : ?mb_bet_place
mb_get_bets(session_data=my_session,runner_id=test_runner_id)
Ce package est en cours de développement actif et les commentaires et suggestions d’améliorations sont les bienvenus.
Veuillez créer un problème en utilisant la zone Problèmes.
LE LOGICIEL EST FOURNI « TEL QUEL », SANS GARANTIE D'AUCUNE SORTE, EXPRESSE OU IMPLICITE, Y COMPRIS MAIS SANS LIMITATION LES GARANTIES DE QUALITÉ MARCHANDE, D'ADAPTATION À UN USAGE PARTICULIER ET DE NON-VIOLATION. EN AUCUN CAS LES AUTEURS OU LES TITULAIRES DES DROITS D'AUTEUR NE SERONT RESPONSABLES DE TOUTE RÉCLAMATION, DOMMAGES OU AUTRE RESPONSABILITÉ, QUE CE SOIT DANS UNE ACTION CONTRACTUELLE, DÉLIT OU AUTRE, DÉCOULANT DE, DE OU EN RELATION AVEC LE LOGICIEL OU L'UTILISATION OU D'AUTRES TRANSACTIONS DANS LE LOGICIEL.