HoopsAPI reference

Basketball odds from multiple bookmakers. One API.

Bookmakers: 1xbet, betway, fanduel, pinnacle, smarkets, unibet. Odds refresh every 10 minutes.

Periods: ft (full game, including overtime), h1, h2, q1–q4.

Markets: moneyline, spread (line is the home team's handicap: -4.5 means home gives 4.5), total, team_total_home, team_total_away.

Main line: where a bookmaker offers several lines, the main one is the most evenly priced.

Authenticate with your API key as a bearer token: curl -H "Authorization: Bearer YOUR_API_KEY" https://hoopsapi.com/api/v1/games. Get a free key at https://hoopsapi.com/sign-up. OpenAPI spec: https://hoopsapi.com/openapi.json.

GET https://hoopsapi.com/api/v1/games — List Games

Upcoming games that have odds, with each bookmaker's main lines for every period.

competition (query, optional): Filter by competition name, case-insensitive (e.g. NBA)

One game with every alternate line. Finished games are served from the archive with their closing odds.

Every price change for a game, newest first (Data plan). Works for upcoming and finished games.

game_id (path, required)
provider (query, optional): Only this bookmaker
market (query, optional, one of moneyline, spread, total, team_total_home, team_total_away): Only this market
period (query, optional, one of ft, h1, h2, q1, q2, q3, q4): Only this period
limit (query, optional, default 500): Max changes to return

Bookmakers and how fresh their data is.

Biggest cross-bookmaker gaps in main lines: moneyline prices, handicap lines and totals (Pro and Data plans).

competition (query, optional): Filter by competition name
limit (query, optional, default 5): Top N per category
period (query, optional, one of ft, h1, h2, q1, q2, q3, q4, default ft): Period to compare