Skip to content

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

1 watching

Forks

Repository files navigation

🤖 Arbitrage Betting System

License: MIT Python: 3.x

An automated Python application for detecting arbitrage betting opportunities (known as "sure bets") across multiple online bookmakers, derived from a technical analysis performed in an academic thesis.

✨ Overview

This program automatically scrapes betting odds from selected European bookmaker websites and uses a mathematical algorithm to identify arbitrage opportunities. An arbitrage bet occurs when placing wagers on all possible outcomes across different bookmakers guarantees a profit, as the sum of inverse odds is less than 1.

The core function is to provide the user with high-margin opportunities quickly for manual placement. Initial testing found an average margin of 1.56% per identified bet.

🚀 Features

  • Automated Scraping: Connects to bookmaker websites, leveraging Selenium and Chromium/Chromedriver to handle dynamic content loading and JavaScript.
  • Evasion Layer: Utilizes undetected-chromedriver to optimize browser behavior and minimize the chance of detection by sophisticated anti-bot systems.
  • Intelligent Matching: Implements logic using regex to correctly pair the same betting events (matches) across different bookmakers, despite inconsistencies in their naming and formatting.
  • Arbitrage Calculation: Computes the theoretical yield for all valid combinations of odds, identifying profitable arbitrage opportunities where the yield is less than 1.
  • Notification System: Sends automatic alerts with full details of identified sure bets to a configured Slack workspace.
  • Data Logging: Stores raw extracted odds and confirmed arbitrage bets in structured CSV files for historical analysis and debugging using NumPy.

💻 Technologies

Category Technology Purpose
Main Language Python Core programming and logic implementation
Web Automation Selenium Controls the web browser for navigation and interaction
Bot Evasion Undetected Chromedriver Helps prevent scraping detection mechanisms
Data Processing NumPy Efficiently handles array-based calculation of arbitrage margins
Communication Slack SDK Manages the notification system for new opportunities
Configuration YAML/Config files Stores environment and application settings

⚠️ Legal Note and Disclaimer

This software is provided for academic and informational purposes only.

  • Automation Risk: Many bookmakers explicitly prohibit the use of automated software (bots) to access their data or place bets. This program is designed only to find and notify the user of the opportunity; it does not automatically place bets.
  • Liability: The developer of this tool assumes no responsibility for any financial losses, account suspensions, or legal issues resulting from the use or misuse of this software. By using this tool, you acknowledge that you are solely responsible for compliance with the terms and conditions of any third-party betting services.

🛠️ Setup and Installation

  1. Install required Python packages:
    pip install -r requirements.txt
  2. Configure your application and platform tokens in the configs/project_config.yaml file.
  3. Ensure you have the correct Chromedriver binary installed and accessible, compatible with your version of Chrome/Chromium.
  4. Run the application:
    python main.py
  5. Possible running in cron job by running cron_job.sh file:
    ./cron_job.sh

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages