slickbet.screener¶

Betting screener for finding and ranking soccer betting opportunities.

Fetches upcoming fixtures via LivescoreClient, filters by league/country, enriches matches with stats, runs BettingModel, and ranks predictions. Also provides display helpers format_prediction and format_summary.

Attributes¶

`ALL_LEAGUE_IDS`
`AMERICAS_LEAGUE_IDS`
`AMERICAS_LEAGUE_NAMES`
`ASIA_LEAGUE_IDS`
`ASIA_LEAGUE_NAMES`
`CUP_COMPETITION_IDS`
`CUP_NAME_PATTERNS`
`MAJOR_LEAGUE_IDS`
`MAJOR_LEAGUE_NAMES`
`MINOR_LEAGUE_IDS`
`MINOR_LEAGUE_NAMES`

Classes¶

`BettingScreener`	Main screener class for finding betting opportunities.
`ScreenerConfig`	Configuration for the betting screener.
`ScreenerResult`	Result of running the betting screener.

Functions¶

`format_prediction`(→ str)	Format a prediction for display.
`format_summary`(→ str)	Format a summary of screener results.
`get_best_double_chance_prob`(→ float)	Get the best double chance probability from a prediction.
`to_central_time`(→ datetime.datetime)	Convert a datetime to Central Time (CST/CDT).

Module Contents¶

slickbet.screener.ALL_LEAGUE_IDS¶

slickbet.screener.AMERICAS_LEAGUE_IDS¶

slickbet.screener.AMERICAS_LEAGUE_NAMES = ['liga professional', 'argentina', 'serie a', 'brazil', 'liga mx', 'mexico']¶

slickbet.screener.ASIA_LEAGUE_IDS¶

slickbet.screener.ASIA_LEAGUE_NAMES = ['saudi', 'pro league', 'hyundai a-league', 'a-league', 'australia', 'j. league', 'j league', 'japan']¶

class slickbet.screener.BettingScreener(config: ScreenerConfig | None = None, api_client: slickbet.api.LivescoreClient | None = None, model: slickbet.model.BettingModel | None = None)[source]¶

Main screener class for finding betting opportunities.

Examples

>>> screener = BettingScreener()
>>> result = screener.screen_tomorrow()
>>> for bet in result.get_top_k(10):
...     print(bet)

client¶

config¶

model¶

screen_date(date: datetime.datetime) → ScreenerResult[source]¶

Screen matches for a specific date.

Parameters:: date (datetime) – The date to screen
Returns:: ScreenerResult – ScreenerResult with ranked predictions

screen_days(days: int = 7) → ScreenerResult[source]¶

Screen matches for the next N calendar days (not 24-hour windows).

Uses calendar-day logic so results are invariant of run time; each day includes all games that kick off that day in Central time.

Parameters:: days (int, optional) – Number of calendar days to screen (default: 7)
Returns:: ScreenerResult – ScreenerResult with ranked predictions from all days

screen_tomorrow() → ScreenerResult[source]¶

Screen tomorrow’s matches (next calendar day, all fixtures that day).

Uses calendar-day logic so results are invariant of run time: e.g. running at 8am or 11pm both get the same “tomorrow” fixtures.

Returns:: ScreenerResult – Ranked predictions for tomorrow’s fixtures.

slickbet.screener.CUP_COMPETITION_IDS¶

slickbet.screener.CUP_NAME_PATTERNS = ['cup', 'copa', 'coupe', 'coppa', 'pokal', 'super cup', 'supercup', 'community shield', 'charity...¶

slickbet.screener.MAJOR_LEAGUE_IDS¶

slickbet.screener.MAJOR_LEAGUE_NAMES = ['bundesliga', 'premier league', 'la liga', 'laliga', 'serie a', 'ligue 1']¶

slickbet.screener.MINOR_LEAGUE_IDS¶

slickbet.screener.MINOR_LEAGUE_NAMES = ['belgian pro league', 'pro league', 'primeira liga', 'portugal', 'super lig', 'turkey',...¶

class slickbet.screener.ScreenerConfig[source]¶

Configuration for the betting screener.

min_probability¶

Minimum win probability for a bet to be kept (default 0.55).

Type:: float

min_confidence¶

Minimum model confidence threshold (default 0.10).

Type:: float

fetch_detailed_stats¶

If True, enrich matches with form/standings/H2H/performance.

Type:: bool

max_workers¶

Concurrent API workers for enrichment.

Type:: int

countries¶

Country name filters (empty = all).

Type:: list[str]

competitions¶

Competition name filters (empty = all).

Type:: list[str]

competition_ids¶

Competition ID filters (empty = all).

Type:: list[str]

major_leagues_only¶

Restrict to top-5 European leagues.

Type:: bool

asia_leagues_only¶

Restrict to configured Asia leagues.

Type:: bool

americas_leagues_only¶

Restrict to configured Americas leagues.

Type:: bool

all_leagues¶

Include major + minor European + Asia + Americas.

Type:: bool

__post_init__() → None[source]¶: Normalize None list fields to empty lists.

all_leagues: bool = False¶

americas_leagues_only: bool = False¶

asia_leagues_only: bool = False¶

competition_ids: list[str] | None = None¶

competitions: list[str] | None = None¶

countries: list[str] | None = None¶

fetch_detailed_stats: bool = True¶

major_leagues_only: bool = False¶

max_workers: int = 5¶

min_confidence: float = 0.1¶

min_probability: float = 0.55¶

class slickbet.screener.ScreenerResult[source]¶

Result of running the betting screener.

get_away_wins() → list[slickbet.model.BetPrediction][source]¶: Get all predictions recommending away win.

get_home_wins() → list[slickbet.model.BetPrediction][source]¶: Get all predictions recommending home win.

get_top_k(k: int) → list[slickbet.model.BetPrediction][source]¶

Get top K betting opportunities by double chance.

Parameters:: k (int) – Number of predictions to return.
Returns:: list[BetPrediction] – Top k predictions sorted by best double-chance probability.

matches_filtered: int¶

predictions: list[slickbet.model.BetPrediction]¶

timestamp: datetime.datetime¶

property top_bets: list[slickbet.model.BetPrediction]¶: Get predictions sorted by best double chance probability (highest first).

property top_bets_by_win: list[slickbet.model.BetPrediction]¶: Get predictions sorted by win probability (highest first).

total_matches_scanned: int¶

slickbet.screener.format_prediction(prediction: slickbet.model.BetPrediction, rank: int = 0) → str[source]¶

Format a prediction for display.

Parameters:

prediction (BetPrediction) – The prediction to format
rank (int, optional) – Optional rank number to display

Returns:

str – Formatted string representation

slickbet.screener.format_summary(result: ScreenerResult) → str[source]¶

Format a summary of screener results.

Parameters:: result (ScreenerResult) – The screener result to summarize
Returns:: str – Formatted summary string

slickbet.screener.get_best_double_chance_prob(prediction: slickbet.model.BetPrediction) → float[source]¶

Get the best double chance probability from a prediction.

Parameters:: prediction (BetPrediction) – Model prediction (may include double_chance).
Returns:: float – Best double-chance probability, or win probability as fallback.

slickbet.screener.to_central_time(dt: datetime.datetime) → datetime.datetime[source]¶

Convert a datetime to Central Time (CST/CDT).

Parameters:: dt (datetime) – Datetime object (assumed to be naive/UTC)
Returns:: datetime – Datetime object in Central Time