BetHub Betting API
Welcome to the BetHub Betting API documentation. This API provides access to betting odds, live scores, and game predictions for various sports and leagues. Below you will find detailed information on the available endpoints and their responses.
Endpointsβ
Betting Odds πβ
Endpoint: GET /api/betting/oddsβ
Retrieve betting odds for a specified sport and league.
Example Request:
GET http://localhost:3000/api/betting/odds?sport=soccer&league=bundesliga&time=tomorrow
{
"league": "bundesliga",
"sport": "soccer",
"date": "2023-11-02",
"games": [
{
"matchup": "Bayern Munich vs Borussia Dortmund",
"odds": {
"home_win": 1.65,
"draw": 3.75,
"away_win": 5
}
},
{
"matchup": "RB Leipzig vs Bayer Leverkusen",
"odds": {
"home_win": 2.1,
"draw": 3.4,
"away_win": 3.25
}
},
{
"matchup": "Wolfsburg vs Freiburg",
"odds": {
"home_win": 2.5,
"draw": 3.3,
"away_win": 2.8
}
},
{
"matchup": "Union Berlin vs Eintracht Frankfurt",
"odds": {
"home_win": 2.05,
"draw": 3.5,
"away_win": 3.4
}
}
]
}
Sport Scores β½β
Endpoint: GET /api/betting/gamesβ
Retrieve live scores for games in a specified sport and league.
Example Request:
GET http://localhost:3000/api/betting/games?sport=basketball&league=nba&time=day
{
"games": {
"games": [
{
"home_team": {
"name": "Los Angeles Lakers",
"score": 102
},
"away_team": {
"name": "Golden State Warriors",
"score": 96
},
"status": "Finished",
"start_time": "19:30"
},
{
"home_team": {
"name": "Boston Celtics",
"score": 114
},
"away_team": {
"name": "Brooklyn Nets",
"score": 107
},
"status": "Finished",
"start_time": "20:00"
},
{
"home_team": {
"name": "Milwaukee Bucks",
"score": 120
},
"away_team": {
"name": "Philadelphia 76ers",
"score": 112
},
"status": "Finished",
"start_time": "19:00"
},
{
"home_team": {
"name": "Miami Heat",
"score": 99
},
"away_team": {
"name": "Dallas Mavericks",
"score": 105
},
"status": "Finished",
"start_time": "21:00"
}
]
}
}
Betting Predictions #οΈβ£β
Endpoint: GET /api/betting/predictionsβ
Retrieve betting predictions and trends for a specified sport and league.
Example Request:
GET http://localhost:3000/api/betting/predictions?sport=basketball&league=nba
{
"predictionsAndTrends": {
"nba_analysis": {
"trend_analysis": {
"team_performance": {
"consistent_teams": [
{
"team": "Golden State Warriors",
"strengths": [
"Three-point shooting",
"Ball movement"
],
"weaknesses": [
"Injuries",
"Rebounding"
],
"historical_performance": {
"last_5_seasons": {
"championships": 2,
"playoff_appearances": 4
}
}
},
{
"team": "Milwaukee Bucks",
"strengths": [
"Defense",
"Star player impact"
],
"weaknesses": [
"Perimeter shooting",
"Depth"
],
"historical_performance": {
"last_5_seasons": {
"championships": 1,
"playoff_appearances": 5
}
}
}
],
"emerging_teams": [
{
"team": "Memphis Grizzlies",
"strengths": [
"Young talent",
"Athleticism"
],
"weaknesses": [
"Experience",
"Consistency"
],
"historical_performance": {
"last_5_seasons": {
"championships": 0,
"playoff_appearances": 3
}
}
},
{
"team": "Atlanta Hawks",
"strengths": [
"Offensive depth",
"Three-point shooting"
],
"weaknesses": [
"Defense",
"Turnovers"
],
"historical_performance": {
"last_5_seasons": {
"championships": 0,
"playoff_appearances": 4
}
}
}
]
},
"player_performance": {
"mvp_candidates": [
{
"player": "Giannis Antetokounmpo",
"team": "Milwaukee Bucks",
"strengths": [
"Scoring",
"Defense",
"Rebounding"
],
"weaknesses": [
"Free-throw shooting",
"Three-point shooting"
]
},
{
"player": "Luka DonΔiΔ",
"team": "Dallas Mavericks",
"strengths": [
"Playmaking",
"Scoring",
"Versatility"
],
"weaknesses": [
"Defense",
"Turnovers"
]
}
]
},
"game_patterns": {
"high_scoring_games": {
"teams": [
"Brooklyn Nets",
"Phoenix Suns"
],
"average_points_per_game": {
"Brooklyn Nets": 115.4,
"Phoenix Suns": 113.3
}
},
"defensive_battles": {
"teams": [
"Miami Heat",
"Utah Jazz"
],
"average_opponent_points_per_game": {
"Miami Heat": 105.9,
"Utah Jazz": 106.4
}
}
}
},
"betting_analysis": {
"strategies": {
"spread_betting": {
"historical_performance": {
"success_rate": "54%",
"successful_teams": [
"Golden State Warriors",
"Los Angeles Clippers"
],
"key_trends": [
"Strong home performance",
"Injury impact on spreads"
]
}
},
"over_under_betting": {
"historical_performance": {
"success_rate": "51%",
"high_scoring_teams": [
"Brooklyn Nets",
"Portland Trail Blazers"
],
"low_scoring_teams": [
"Miami Heat",
"New York Knicks"
]
}
}
}
},
"predictions": {
"season_outlook": {
"championship_favorites": [
"Milwaukee Bucks",
"Golden State Warriors"
],
"playoff_predictions": {
"Eastern_Conference": [
"Milwaukee Bucks",
"Brooklyn Nets",
"Miami Heat"
],
"Western_Conference": [
"Golden State Warriors",
"Phoenix Suns",
"Los Angeles Lakers"
]
}
},
"betting_outlook": {
"spread_betting": {
"favorable_teams": [
"Golden State Warriors"
],
"watch_teams": [
"Philadelphia 76ers"
]
},
"over_under_betting": {
"favorable_teams": [
"Brooklyn Nets"
],
"watch_teams": [
"Dallas Mavericks"
]
}
}
}
}
}
}
Supportβ
For further assistance, please refer to our FAQ or Contact Support.