Skip to content

Latest commit

 

History

History
196 lines (162 loc) · 5.81 KB

README.md

File metadata and controls

196 lines (162 loc) · 5.81 KB
Raw

BettingBook CLI

A CLI to keep track of your soccer bets.

Install

An API key from Sportsmonks will be required and you can register for one here.

Build from source

$ git clone https://github.com/sebastiaanspeck/bettingbook-cli.git
$ cd bettingbook-cli/src

Notes:

  • Currently only tested on Windows and MacOS with Python 3. Might work on other platforms, but this is not yet tested.

  • To get colorized terminal output on Windows, make sure to install ansicon and colorama.

  • You need the packages click and requests. You can install these using pip (pip install <package>).

Usage

View live scores from various leagues

$ bettingbook.py --live

View matches from various leagues for today

$ bettingbook.py --today

Note:

--live only shows the matches that are live now or are finished, to view games that have not started yet, use --today

Get scores for all leagues with a set time period

$ bettingbook.py --matches --days=10 # get scores for all leagues over the coming 10 days

Get scores for a particular league

$ bettingbook.py --matches --league=DE1 # DE1 is the league code for Bundesliga
$ bettingbook.py --matches --league=FR1 --history --days=15 # get scores for all the French Ligue 1 games over the past 15 days
$ bettingbook.py --matches --league=EN1 --history --details # get scores for all the Premier League games over the past 6 days and showing the goalscorers.
$ bettingbook.py --matches --league=NL1 --history --odds # get odds for all the Eredivisie games over the past 6 days and showing the odds (in corresponding colors).

View all your bets

$ bettingbook.py --all_bets

View account details

$ bettingbook.py --account

Help

$ bettingbook.py --help

List of supported leagues & cups and their league codes

  • Germany:
    • DE1: Bundesliga
    • DEC: DFB Pokal
  • France:
    • FR1: Ligue 1
    • FRC: Coupe de France
  • Spain:
    • ES1: La Liga
    • ESC: Copa Del Rey
  • Italy:
    • IT1: Serie A
    • ITC: Coppa Italia
  • England:
    • EN1: Premier League
    • ENC: FA Cup
  • Portugal:
    • PT1: Primeira Liga
  • Netherlands:
    • NL1: Eredivisie
    • NL2: Eerste Divisie/Keuken Kampioen Divisie
    • NLC: KNVB Beker
  • Belgium:
    • BE1: Pro League
    • BEC: Belgian Cup
  • Europe:
    • CL: Champions League
    • EL: Europa League
    • WCEQ: WC Qualification Europe
    • EQ: Euro Qualification
    • EC: European Chamionship
    • UNL: UEFA Nations League
  • World:
    • WC: World Cup

Supported leagues & cups

For a full list of supported leagues & cups see this.

Commands and possible arguments

  • --live (-L):
    • --league (-l)
    • --details (-D)
    • --odds (-O)
    • --bet (-B)
    • --refresh (-R)
  • --today (-T):
    • --league (-l)
    • --details (-D)
    • --odds (-O)
    • --bet (-B)
    • --refresh (-R)
  • --matches (-M):
    • --league (-l)
    • --days (-d)
    • --history (-H)
    • --details (-D)
    • --odds (-O)
    • --bet (-B)
  • --standings (-S):
    • --league (-l)
  • --all_bets (-AB)
  • --open_bets (-OB)
  • --closed_bets (-CB)
  • --profile (-P)
  • --possible_leagues (-PL)

Commands (live, today, matches, standings) and flags (details, odds, history, bet and refresh) can be used as -UPPERCASE.
Parameters (league, days) can also be used as -lowercase

Abbreviations

The abbreviations you can see when using live, today or matches are explained down here:

Abbreviation Definition Information
NS Not Started The initial status of a game
LIVE Live The game is currently in-play
HT Half-Time The game currently is in half-time
FT Full-Time The game has ended after 90 minutes
ET Extra-Time The game currently is in extra time, can happen in knockout games
PEN_LIVE Penalty Shootout ET status didn't get a winner, penalties are taken to determine the winner
AET Finished after extra time The game has finished after 120 minutes
BREAK Regular time finished Waiting for extra time or penalties to start
FT_PEN Full-Time after penalties Finished after penalty shootout
CANCL Cancelled The game has been cancelled
POSTP Postponed The game has been postponed
INT Interrupted The game has been interrupted. Can be due to bad weather
ABAN Abandoned The game has abandoned and will continue at a later time or day
SUSP Suspended The game has suspended and will continue at a later time or day
AWARDED Awarded Winner is being decided externally
DELAYED Delayed The game is delayed so it wil start later
TBA To Be Announced Fixture will be updated with exact time later
WO Walkover Awarding of a victory to a contestant because there are no other contestants
AU Awaiting Updates Can occur when there is a connectivity issue or something

Todo

  • Add more competitions (divisions under the first divisions)
  • Add option to get matches for a specific team
  • Add support to show cards
  • Add support for live betting
  • Update balance at runtime
  • Add built-in watch feature so you can run once with --live and just leave the program running.
  • Add option to view active/finished bets.
  • Add odds to match overviews
  • Add color coding for Europa league and Champions League
  • Add cups
  • Add Champions League and Europa League
  • Add detailed information to match results
  • Add league filter for live scores
  • Add league standings
  • Add --details to league standings (details are won, draw, lost, goal for, goal against)
  • Add betting functions

License

Open sourced under MIT License

Notes

This project is still in development. It works but it may contain bugs. If you find a bug, please open report issue via Github.