Skip to content

ukoddsapi/uk-arb-scanner

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

UK Football Arbitrage Scanner

Find guaranteed-profit arbitrage opportunities across 25+ UK bookmakers.

Scans Bet365, Sky Bet, Paddy Power, William Hill, Ladbrokes, Coral, Betfred, BetVictor, 888sport, Unibet, BoyleSports, Betway, Betfair Exchange, and more — every 60 seconds.

Python License

What it does

  • Scans all 25+ UK bookmakers for pricing disagreements
  • Calculates exact stakes for your bankroll
  • Shows guaranteed profit and ROI per arb
  • Deduplicates — only alerts on NEW opportunities
  • Optional Telegram push notifications
  • Logs all arbs to JSON for tracking
  • Docker support for 24/7 operation

Quick start

git clone https://github.com/ukoddsapi/uk-arb-scanner.git
cd uk-arb-scanner
pip install -r requirements.txt
cp .env.example .env
# Edit .env and add your UKOddsApi key
python scanner.py

Example output

=================================================================
🔥🔥🔥  NEW ARB: 7.55% profit
=================================================================
⚽ Cardiff City vs Northampton
   English League One
   Kick-off: 2026-04-25T14:00:00Z
   Market: Total Away Corners — Over 1.5 vs Under 1.5

   💰 Stake Plan (£500)
   Bookmaker         Bet                  Odds     Stake    Return
   ----------------------------------------------------------------
   William Hill      Over 1.5             1.50      £358      £537.00
   BoyleSports       Under 1.5            3.80      £142      £539.60

   ✅ Guaranteed profit: £37.00 (7.4% ROI)

Configuration

Edit .env to configure:

UKODDS_API_KEY=your_key      # Required — get at ukoddsapi.com
BANKROLL=500                  # Total stake per arb (£)
MIN_PROFIT=0.5                # Minimum profit percentage
SCAN_INTERVAL=60              # Seconds between scans
ROUND_STAKES=1                # Round stakes to nearest £

Telegram alerts

Get push notifications on your phone when arbs are found:

  1. Message @BotFather on Telegram to create a bot
  2. Get your chat ID from @userinfobot
  3. Add to .env:
TELEGRAM_BOT_TOKEN=123456:ABC-DEF...
TELEGRAM_CHAT_ID=your_chat_id

Docker

Run 24/7 on any server:

docker build -t uk-arb-scanner .
docker run -d --env-file .env --name arb-scanner uk-arb-scanner

How arbitrage works

When two bookmakers disagree on the probability of an outcome enough that you can bet on every result and still profit:

  • William Hill offers Over 1.5 Corners at 1.50 (implied probability: 66.7%)
  • BoyleSports offers Under 1.5 Corners at 3.80 (implied probability: 26.3%)
  • Combined: 93.0% (below 100% = guaranteed profit of ~7%)

The scanner finds these automatically across all 25+ UK bookmakers and 100+ markets.

Why UK bookmaker coverage matters

More bookmakers = more pricing disagreements = more arbs.

  • 5 bookmakers: 10 possible pairs
  • 10 bookmakers: 45 possible pairs
  • 25 bookmakers: 300 possible pairs

UKOddsApi covers every major UK bookmaker. Most other odds APIs only have 3-5 active UK books.

Requirements

  • Python 3.8+
  • UKOddsApi Scale plan (arbitrage endpoint) — ukoddsapi.com

License

MIT


Powered by UKOddsApi — pre-match football odds from 25+ UK bookmakers.

About

Find guaranteed-profit arbitrage opportunities across 25+ UK bookmakers.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors