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?

MarketWhat it settles on
totalCombined points of both teams
team_total_homePoints scored by the home team
team_total_awayPoints scored by the away team

Each line has the points line and the over and under prices:

a totals line
{ "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:

GET /v1/games/{game_id}
"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 line as 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.