API Endpoints

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

Matches

GET /matches/today

Today's matches.

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

GET /matches/upcoming

Upcoming matches (next 7 days).

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

GET /matches/

Single match details.

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

GET /matches/{match_id}/prediction

Prediction for a specific match.

Predictions

GET /predictions/today

Today's predictions.

GET /predictions/value-bets

Identified value bets.

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

Analytics

GET /analytics/accuracy

Model accuracy statistics.

{
  "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 and profit.

GET /analytics/bankroll

Bankroll status and equity curve.

Leagues

GET /leagues

Supported leagues list.

GET /leagues/{league_id}/matches

League matches.

GET /leagues/{league_id}/standings

Standings.

Teams

GET /teams/

Team details.

GET /teams/{team_id}/matches

Team matches.

GET /teams/{team_id}/form

Recent form (last 5/10 matches).

Odds

GET /odds/

Odds for a match.

{
  "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

Background jobs status.

POST /jobs/trigger/

Manually execute job (requires API key).

Rate Limit

GET /rate-limit/status

API quota used.

Health

GET /health

Health check.

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

Authentication

Some endpoints require API key:

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

Swagger Documentation

Interactive documentation: http://localhost:8000/docs