Basketball Totals and Team Totals Odds API
Over/under odds for the game and for each team, with alternate lines, from multiple bookmakers.
By the HoopsAPI team · Updated
HoopsAPI returns basketball over/under odds from 6 bookmakers for the game total and for each team's total, with every alternate line, for the full game, both halves and all four quarters. All markets use the same structure across bookmakers and over 100 competitions.
Which totals markets are included?
| Market | What it settles on |
|---|---|
total | Combined points of both teams |
team_total_home | Points scored by the home team |
team_total_away | Points scored by the away team |
Each line has the points line and the over and under prices:
{ "line": 162.5, "over": 1.87, "under": 1.95 }Full-game totals (period ft) include overtime. Team totals are offered by fewer bookmakers than game totals; markets a bookmaker doesn't offer are simply absent from its entry.
Does it include alternate totals lines?
GET /v1/gamesreturns each bookmaker's main line per market, the line with the most balanced prices. GET /v1/games/{game_id} adds every alternate line under lines, main line first:
"lines": {
"ft": {
"unibet": {
"total": [
{ "line": 162.5, "over": 1.87, "under": 1.95 },
{ "line": 158.5, "over": 1.55, "under": 2.40 },
{ "line": 160.5, "over": 1.70, "under": 2.12 },
...
],
"team_total_home": [ { "line": 84.5, "over": 1.83, "under": 1.91 } ],
"team_total_away": [ { "line": 77.5, "over": 1.87, "under": 1.87 } ]
}
}
}What is totals data useful for?
- Projected scores.A game total and handicap together imply each team's expected points: home = (total - line) / 2, away = (total + line) / 2, with
lineas the home handicap. Team totals let you check that directly. - Comparing bookmakers. Totals lines often differ by a point or more between bookmakers. Compare prices at the same line using the alternates; see how much basketball odds differ.
- Fair probabilities. De-vig the over and under to get the market's probability of each; see removing the bookmaker margin.
Are totals available for halves and quarters?
Totals and team totals are also available for halves (h1, h2) and quarters (q1–q4) where bookmakers price them. See the quarter and half odds API.
Try it with real data
The free plan includes 10 requests a day across every league and market. No credit card.