# Betting Markets
The Odds API covers the betting markets listed below. These are the most common markets that are featured by bookmakers. We are exploring additional markets to add in future.
# Types of Betting Markets
Terminology for betting markets can vary by country, sport and even amongst bookmakers. We try to simplify this by defining the following markets
|Market Key |
in the API
|h2h||Head to head, Moneyline||Bet on the winning team or player of a game (includes the draw for soccer)|
|spreads||Points spread, Handicap||The spreads market as featured by a bookmaker. Bet on the winning team after a points handicap has been applied to each team|
|totals||Total points/goals, Over/Under||The totals market as featured by a bookmaker. Bet on the total score of the game being above or below a threshold|
|outrights||Outrights, Futures||Bet on a final outcome of a tournament or competition|
|h2h_lay||Same as h2h||Bet against an outcome. This market is only applicable to betting exchanges|
|outrights_lay||Same as outrights||See h2h_lay for a description of lay bets|
totals markets are mainly available for US sports and bookmakers at this time.
# Examples of Betting Markets
# Head to Head / Moneyline Bets
These examples use American odds:
$250 is wagered on a team with odds of -250. If the team wins, the bettor receives a profit of $100, and a payout of $250 + $100 = $350
$100 is wagered on a team with odds of 300. If the team wins, the bettor receives a profit of $300, and a payout of $100 + $300 = $400
This example uses decimal odds:
$100 wagered on a team with odds of 2.5. If the team wins, the bettor receives a payout of 100 x 2.5 = $250, and a profit of $250 - $100 = $150
# Lay Bets for Head to Head / Moneyline
Laying a bet is like taking the position of a bookmaker. A bet is made against a winning outcome. This example uses decimal odds:
If you wager $100 on a team with decimal odds of 2 as a lay bet, you are betting the team will lose. Another bettor is backing your bet by wagering $100 on those same odds of 2. If the team wins, you lose your $100 to the backer (their profit, your loss). If the team loses, you keep the backer's wager of $100 (your profit, their loss), giving you a payout of $100 + $100 = $200
# Point Spread / Handicap Bets
Bet on the winning team after a handicap of points has been applied on each team. This example uses American odds:
A Utah Jazz vs LA Clippers game had point spread odds of Utah Jazz -112 (-3.5 points) and LA Clippers -109 (+3.5 points).
Utah Jazz is seen as the stronger team and is handicapped by 3.5 points. LA Clippers are given a bonus of +3.5 points.
If you bet on Utah Jazz, they will need to win by more than 3.5 points (i.e. at least 4 points) in order to win the bet at odds -112. If you bet on LA Clippers, they can either lose by less the 3.5 points (i.e. lose by 3 points or less), or win the game in order to win the bet at odds of -109.
# Totals / Over/Under Bets
Bet on the total score of the game being above or below a threshold. This example uses American odds:
A Utah Jazz vs LA Clippers game showed over/under odds as over 234.5 points at odds of -109, under 234.5 points at odds -112.
A bet on the over side will win if the total points of the game are 235 or more.
A bet on the under side will win if the total points of the game are 234 or less.
# Outrights / Futures Bets
Futures bets try to pick the final outcome of a tournament or a competition, usually amongst many possible outcomes. Examples include
- Betting on the winning team of this season's NFL Superbowl
- Betting on a player finishing in the top 3 of a golf tournament
- Betting on the next US President amongst the candidates
# Get Started
To discover the sports and bookmakers we cover, the first thing you'll need is an API key
To get started with the JSON API, see
To get sports odds in Excel or Google Sheets at the click of a button (no coding needed), see