godfather68/shots-aggregator

Shots Aggregator — Total Shots Predictions

ML-powered total shots predictions for football matches, featuring an XGBoost ensemble trained on 94K+ historical matches across 18 leagues.

Features

• —ML Predictions — XGBoost ensemble (regression + quantile + classifier)
• —Daily Scanner — ranked matches by composite pick quality score
• —Auto Parlays — 2-3 leg combos generated daily, tracked against results
• —Per-League Calibration — bias correction from historical accuracy
• —Result Tracking — automated matching of predictions to actual outcomes
• —Auto Retraining — model retrains when 50+ new results are collected

API Endpoints

Model

• —Training Data: 94K+ matches, 18 leagues, 20 seasons (2005-2025)
• —Features: 120+ engineered features (form, H2H, odds, standings)
• —Architecture: XGBoost ensemble (point estimate + p10/p90 quantiles + binary classifier)
• —Performance: MAE ~4.3 shots, CV MAE ~4.4 shots

Local Development

python -m venv venv
source venv/bin/activate    # Windows: venv\Scripts\activate
pip install -r requirements.txt
cp .env.example .env        # Add your ODDS_API_KEY
PORT=8000 python run.py     # Visit http://localhost:8000

Disclaimer

This tool is for informational and experimental purposes only. Always gamble responsibly.