API Endpoints

Base URL: http://localhost:8000/api/v1

Matches

GET /matches/today

Partite di oggi.

curl http://localhost:8000/api/v1/matches/today

GET /matches/upcoming

Partite future (prossimi 7 giorni).

curl http://localhost:8000/api/v1/matches/upcoming?days=7

GET /matches/

Dettaglio singola partita.

curl http://localhost:8000/api/v1/matches/12345

GET /matches/{match_id}/prediction

Predizione per una partita specifica.

Predictions

GET /predictions/today

Predizioni di oggi.

GET /predictions/value-bets

Value bet identificati.

curl "http://localhost:8000/api/v1/predictions/value-bets?min_ev=5.0"

Analytics

GET /analytics/accuracy

Statistiche accuracy modelli.

{
  "model": "PRODUCTION_V3_GBM",
  "period": "30d",
  "accuracy_1x2": 0.62,
  "accuracy_over25": 0.64,
  "accuracy_btts": 0.52,
  "rps": 0.160,
  "total_predictions": 450
}

GET /analytics/roi

ROI e profitto.

GET /analytics/bankroll

Stato bankroll e equity curve.

Leagues

GET /leagues

Lista leghe supportate.

GET /leagues/{league_id}/matches

Partite di una lega.

GET /leagues/{league_id}/standings

Classifica.

Teams

GET /teams/

Dettaglio squadra.

GET /teams/{team_id}/matches

Partite squadra.

GET /teams/{team_id}/form

Form recente (ultime 5/10 partite).

Odds

GET /odds/

Quote per una partita.

{
  "match_id": 12345,
  "bookmakers": [
    {
      "name": "Bet365",
      "odds_home": 2.10,
      "odds_draw": 3.40,
      "odds_away": 3.60,
      "over_25": 1.85,
      "under_25": 1.95
    }
  ]
}

Jobs

GET /jobs/status

Stato background jobs.

POST /jobs/trigger/

Esegue job manualmente (richiede API key).

Rate Limit

GET /rate-limit/status

Quota API utilizzata.

Health

GET /health

Health check.

{
  "status": "healthy",
  "database": "connected",
  "redis": "connected",
  "scheduler": "running",
  "jobs_active": 13
}

Autenticazione

Alcuni endpoint richiedono API key:

curl -H "X-API-Key: your_api_key" http://localhost:8000/api/v1/admin/...

Swagger Documentation

Documentazione interattiva: http://localhost:8000/docs