README.md
In dashee87/betScrapeR: R package to scrape live sports betting odds
betScrapeR
betScrapeR is an R package that combines exchange data from the Betfair API with web scraped odds from various bookmakers (via odds comparison sites). This information can then inform and improve trading strategies.
As it relies on web scraping, any changes to the scraped websites will invalidate the whole package. If you spot any bugs, then please raise an issue or fork it and start a pull request.
Getting Started
Install
Install from GitLab
# install.packages("devtools")
devtools::install_git("https://gitlab.com/dashee87/betScrapeR.git")
library("betScrapeR")
You can install from GitHub (identical mirror of GitLab)
# install.packages("devtools")
devtools::install_github("dashee87/betScrapeR")
library("betScrapeR")
Alternatively, you can copy the R files onto your computer and run them all locally (only if the other approaches fail for some reason).
Required Packages
abettor is a package to perform calls on the Betfair exchange via its API. We will use abettor to retrieve exchange data. Please consult its extensive documentation, if you want design a trading strategy based on data derived from betScrapeR. As abettor is not supported by CRAN, you'll need to install it seperately. Similar to before, just install it directly from RStudio:
Install from GitLab
# install.packages("devtools")
devtools::install_git("https://gitlab.com/phillc73/abettor.git")
library("abettor")
Or install from GitHub if you prefer (identical mirror of GitLab)
# install.packages("devtools")
devtools::install_github("phillc73/abettor")
library("abettor")
This exchange data is combined with the corresponding bookmakers' odds, which are scraped directly from odds comparison websites using rvest. rvest works particularly well in combination with SelectorGadget, a handy internet browser extension that allows you to easily extract css tags from websites. As it's supported by CRAN, rvest will be automatically installed with betScrapeR (if it's not already installed). So it's just abettor that you need to install manually.
Tutorial
I've created a short tutorial on how to install and use betScrapeR, including an example showing how betScrapeR can be used to identify arbs. The tutorial can be viewed here. A tennis specific tutorial is available here.
Obtain a Betfair Developer Application Key
Only people with betfair application (app) keys will be able to use this package. Therefore, you may need to obtain a developer app key for the Exchange API. Please follow the instructions here. If you intend to use this package in a commercial context (e.g. software design), you need to apply for a Betfair Software Vendor Licence. Personal use of the betScrapeR package will only require an Exchange API app key.
Just note that there are two types of application keys: delayed and live. The former is free but provides limited API functionality. For example, you can't place bets and market data is returned with a 1-60 second delay. In contrast, live app keys allow full functionality (place bets, market data with no delay, etc), but cost £299. I'm not too familiar with the delayed app key, as the live app key was free when I started out. If parts of the package are incomptible with a delayed app key, then please submit an issue. Please initially test the package with a delayed app key, bearing in mind your calls will be subject to a delay.
Status
This package is under active development and is currently subject to regular updates.
Currently, the package only supports horse racing (not including races in Australia and New Zealand) and tennis.
Issues
Web scraping alogirithms are very sensitive to minor website changes (and my code is not immune to more general bugs). Please let me know if something's not working.
Future
- Complete horse racing functionality
- Tackle football (one country, one league, one market at a time)
- Shiny apps
Links
- Betfair Online Betting Exchange
- Betfair Developer Program
- Betfair Exchange API Documentation
- rvest Documentation
- Web Scraping with R tutorials
Disclaimer
The betScrapeR package is provided with absolutely no warranty. If you intend to incorporate this package into your trading strategies, please tread carefully. Start with small stakes; a small bug/mistake could lead to big losses.
dashee87/betScrapeR documentation built on May 14, 2019, 6:12 p.m.
R Package Documentation
Browse R Packages
We want your feedback!
Note that we can't provide technical support on individual packages. You should contact the package authors for that.
betScrapeR
betScrapeR is an R package that combines exchange data from the Betfair API with web scraped odds from various bookmakers (via odds comparison sites). This information can then inform and improve trading strategies.
As it relies on web scraping, any changes to the scraped websites will invalidate the whole package. If you spot any bugs, then please raise an issue or fork it and start a pull request.
Getting Started
Install
Install from GitLab
# install.packages("devtools")
devtools::install_git("https://gitlab.com/dashee87/betScrapeR.git")
library("betScrapeR")
You can install from GitHub (identical mirror of GitLab)
# install.packages("devtools")
devtools::install_github("dashee87/betScrapeR")
library("betScrapeR")
Alternatively, you can copy the R files onto your computer and run them all locally (only if the other approaches fail for some reason).
Required Packages
abettor is a package to perform calls on the Betfair exchange via its API. We will use abettor to retrieve exchange data. Please consult its extensive documentation, if you want design a trading strategy based on data derived from betScrapeR. As abettor is not supported by CRAN, you'll need to install it seperately. Similar to before, just install it directly from RStudio:
Install from GitLab
# install.packages("devtools")
devtools::install_git("https://gitlab.com/phillc73/abettor.git")
library("abettor")
Or install from GitHub if you prefer (identical mirror of GitLab)
# install.packages("devtools")
devtools::install_github("phillc73/abettor")
library("abettor")
This exchange data is combined with the corresponding bookmakers' odds, which are scraped directly from odds comparison websites using rvest. rvest works particularly well in combination with SelectorGadget, a handy internet browser extension that allows you to easily extract css tags from websites. As it's supported by CRAN, rvest will be automatically installed with betScrapeR (if it's not already installed). So it's just abettor that you need to install manually.
Tutorial
I've created a short tutorial on how to install and use betScrapeR, including an example showing how betScrapeR can be used to identify arbs. The tutorial can be viewed here. A tennis specific tutorial is available here.
Obtain a Betfair Developer Application Key
Only people with betfair application (app) keys will be able to use this package. Therefore, you may need to obtain a developer app key for the Exchange API. Please follow the instructions here. If you intend to use this package in a commercial context (e.g. software design), you need to apply for a Betfair Software Vendor Licence. Personal use of the betScrapeR package will only require an Exchange API app key.
Just note that there are two types of application keys: delayed and live. The former is free but provides limited API functionality. For example, you can't place bets and market data is returned with a 1-60 second delay. In contrast, live app keys allow full functionality (place bets, market data with no delay, etc), but cost £299. I'm not too familiar with the delayed app key, as the live app key was free when I started out. If parts of the package are incomptible with a delayed app key, then please submit an issue. Please initially test the package with a delayed app key, bearing in mind your calls will be subject to a delay.
Status
This package is under active development and is currently subject to regular updates.
Currently, the package only supports horse racing (not including races in Australia and New Zealand) and tennis.
Issues
Web scraping alogirithms are very sensitive to minor website changes (and my code is not immune to more general bugs). Please let me know if something's not working.
Future
- Complete horse racing functionality
- Tackle football (one country, one league, one market at a time)
- Shiny apps
Links
- Betfair Online Betting Exchange
- Betfair Developer Program
- Betfair Exchange API Documentation
- rvest Documentation
- Web Scraping with R tutorials
Disclaimer
The betScrapeR package is provided with absolutely no warranty. If you intend to incorporate this package into your trading strategies, please tread carefully. Start with small stakes; a small bug/mistake could lead to big losses.
R Package Documentation
Browse R Packages
We want your feedback!
Note that we can't provide technical support on individual packages. You should contact the package authors for that.
Embedding an R snippet on your website
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.