# Betting Markets

The Odds API covers the betting markets listed below.

These are the most common markets that are featured by bookmakers. Terminology for betting markets can vary by country, sport and even amongst bookmakers. We aim to simplify this by defining the following markets

Market Key
(use in the API)
Market Names Description
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 a h2h outcome. This market is only applicable to betting exchanges
outrights_lay Same as outrights Bet against an outrights outcome. This market is only applicable to betting exchanges

spreads and totals markets are mainly available for US sports and bookmakers at this time.

For descriptions of these markets, see examples of betting markets.

# Additional Markets

Starting in 2023, more markets are becoming available in the API. Additional markets are currently limited to US sports and selected bookmakers, however coverage is expanding. Additional markets update at 2 minute intervals pre-match, and 1 minute intervals when in-play.

Due to the growing size of the API response, additional markets need to be accessed one event at a time using the new /events/{eventId}/odds endpoint.

Market Key
(use in the API)
Market Name Description
alternate_spreads Alternate Spreads (handicap) All available point spread outcomes for each team
alternate_totals Alternate Totals (Over/Under) All available over/under outcomes
btts Both Teams to Score Odds that both teams will score during the game. Outcomes are "Yes" or "No". Available for soccer.
draw_no_bet Draw No Bet Odds for the match winner, excluding the draw outcome. A draw will result in a returned bet. Available for soccer
h2h_3_way Head to head / Moneyline 3 way Match winner including draw
team_totals Team Totals Featured team totals (Over/Under)
alternate_team_totals Alternate Team Totals All available team totals (Over/Under)

Suggest new markets

We are exploring new markets to add. Suggest new markets. (opens new window).

For updates on new markets and other features, check out our Twitter page (opens new window).

# Game Period Markets

Game period markets depend on the sport, and can include quarter time odds, half time odds, period odds, and innings odds.

Market Key
(use in the API)
Market Name Note
h2h_q1 Moneyline 1st Quarter
h2h_q2 Moneyline 2nd Quarter
h2h_q3 Moneyline 3rd Quarter
h2h_q4 Moneyline 4th Quarter
h2h_h1 Moneyline 1st Half
h2h_h2 Moneyline 2nd Half
h2h_p1 Moneyline 1st Period Valid for ice hockey
h2h_p2 Moneyline 2nd Period Valid for ice hockey
h2h_p3 Moneyline 3rd Period Valid for ice hockey
h2h_1st_1_innings Moneyline 1st inning Valid for baseball
h2h_1st_3_innings Moneyline 1st 3 innings Valid for baseball
h2h_1st_5_innings Moneyline 1st 5 innings Valid for baseball
h2h_1st_7_innings Moneyline 1st 7 innings Valid for baseball
h2h_3_way_1st_1_innings 3-way moneyline 1st inning Valid for baseball
h2h_3_way_1st_3_innings 3-way moneyline 1st 3 innings Valid for baseball
h2h_3_way_1st_5_innings 3-way moneyline 1st 5 innings Valid for baseball
h2h_3_way_1st_7_innings 3-way moneyline 1st 7 innings Valid for baseball
spreads_q1 Spreads 1st Quarter
spreads_q2 Spreads 2nd Quarter
spreads_q3 Spreads 3rd Quarter
spreads_q4 Spreads 4th Quarter
spreads_h1 Spreads 1st Half
spreads_h2 Spreads 2nd Half
spreads_p1 Spreads 1st Period Valid for ice hockey
spreads_p2 Spreads 2nd Period Valid for ice hockey
spreads_p3 Spreads 3rd Period Valid for ice hockey
spreads_1st_1_innings Spreads 1st inning Valid for baseball
spreads_1st_3_innings Spreads 1st 3 innings Valid for baseball
spreads_1st_5_innings Spreads 1st 5 innings Valid for baseball
spreads_1st_7_innings Spreads 1st 7 innings Valid for baseball
alternate_spreads_1st_1_innings Alternate spreads 1st inning Valid for baseball
alternate_spreads_1st_3_innings Alternate spreads 1st 3 innings Valid for baseball
alternate_spreads_1st_5_innings Alternate spreads 1st 5 innings Valid for baseball
alternate_spreads_1st_7_innings Alternate spreads 1st 7 innings Valid for baseball
alternate_spreads_q1 Alternate spreads Q1
alternate_spreads_h1 Alternate spreads H1
totals_q1 Over/under 1st Quarter
totals_q2 Over/under 2nd Quarter
totals_q3 Over/under 3rd Quarter
totals_q4 Over/under 4th Quarter
totals_h1 Over/under 1st Half
totals_h2 Over/under 2nd Half
totals_p1 Over/under 1st Period Valid for ice hockey
totals_p2 Over/under 2nd Period Valid for ice hockey
totals_p3 Over/under 3rd Period Valid for ice hockey
totals_1st_1_innings Over/under 1st inning Valid for baseball
totals_1st_3_innings Over/under 1st 3 innings Valid for baseball
totals_1st_5_innings Over/under 1st 5 innings Valid for baseball
totals_1st_7_innings Over/under 1st 7 innings Valid for baseball
alternate_totals_1st_1_innings Alternate over/under 1st inning Valid for baseball
alternate_totals_1st_3_innings Alternate over/under 1st 3 innings Valid for baseball
alternate_totals_1st_5_innings Alternate over/under 1st 5 innings Valid for baseball
alternate_totals_1st_7_innings Alternate over/under 1st 7 innings Valid for baseball
alternate_totals_q1 Alternate totals Q1
alternate_totals_h1 Alternate totals H1

# Player Props API Markets

Player props are recently available and currently limited to US sports and selected US bookmakers, starting with FanDuel, DraftKings, Caesars, Bovada and more. We will be expanding coverage over the coming months. Player props update at 2 minute intervals pre-match, and at 1 minute intervals when in-play.

Due to the growing size of the API response, player props need to be accessed one event at a time using the new /events/{eventId}/odds endpoint.

# NFL, NCAAF Player Props API

Market Key
(use in the API)
Market Name
player_pass_tds Pass Touchdowns (Over/Under)
player_pass_yds Pass Yards (Over/Under)
player_pass_completions Pass Completions (Over/Under)
player_pass_attempts Pass Attempts (Over/Under)
player_pass_interceptions Pass Intercepts (Over/Under)
player_pass_longest_completion Pass Longest Completion (Over/Under)
player_rush_yds Rush Yards (Over/Under)
player_rush_attempts Rush Attempts (Over/Under)
player_rush_longest Longest Rush (Over/Under)
player_receptions Receptions (Over/Under)
player_reception_yds Reception Yards (Over/Under)
player_reception_longest Longest Reception (Over/Under)
player_kicking_points Kicking Points (Over/Under)
player_field_goals Field Goals (Over/Under)
player_tackles_assists Tackles + Assists (Over/Under)
player_1st_td 1st Touchdown Scorer (Yes/No)
player_last_td Last Touchdown Scorer (Yes/No)
player_anytime_td Anytime Touchdown Scorer (Yes/No)

# Alternate NFL Player Props API

Market Key
(use in the API)
Market Name
player_pass_tds_alternate Alternate Pass Touchdowns (Over/Under)
player_pass_yds_alternate Alternate Pass Yards (Over/Under)
player_rush_yds_alternate Alternate Rush Yards (Over/Under)
player_rush_reception_yds_alternate Alternate Rush Reception Yards (Over/Under)
player_reception_yds_alternate Alternate Reception Yards (Over/Under)
player_receptions_alternate Alternate Receptions (Over/Under)

# NBA, NCAAB, WNBA Player Props API

Market Key
(use in the API)
Market Name
player_points Points (Over/Under)
player_rebounds Rebounds (Over/Under)
player_assists Assists (Over/Under)
player_threes Threes (Over/Under)
player_blocks Blocks (Over/Under)
player_steals Steals (Over/Under)
player_blocks_steals Blocks + Steals (Over/Under)
player_turnovers Turnovers (Over/Under)
player_points_rebounds_assists Points + Rebounds + Assists (Over/Under)
player_points_rebounds Points + Rebounds (Over/Under)
player_points_assists Points + Assists (Over/Under)
player_rebounds_assists Rebounds + Assists (Over/Under)
player_first_basket First Basket Scorer (Yes/No)
player_double_double Double Double (Yes/No)
player_triple_double Triple Double (Yes/No)

# Alternate NBA Player Props API

Alternate player prop markets include X+ lines, and markets labeled by bookmakers as "alternate".

Market Key
(use in the API)
Market Name
player_points_alternate Alternate Points (Over/Under)
player_rebounds_alternate Alternate Rebounds (Over/Under)
player_assists_alternate Alternate Assists (Over/Under)
player_blocks_alternate Alternate Blocks (Over/Under)
player_steals_alternate Alternate Steals (Over/Under)
player_threes_alternate Alternate Threes (Over/Under)
player_points_assists_alternate Alternate Points + Assists (Over/Under)
player_points_rebounds_alternate Alternate Points + Rebounds (Over/Under)
player_rebounds_assists_alternate Alternate Rebounds + Assists (Over/Under)
player_points_rebounds_assists_alternate Alternate Points + Rebounds + Assists (Over/Under)

# MLB Player Props API

Market Key
(use in the API)
Market Name
batter_home_runs Batter home runs (Over/Under)
batter_hits Batter hits (Over/Under)
batter_total_bases Batter total bases (Over/Under)
batter_rbis Batter RBIs (Over/Under)
batter_runs_scored Batter runs scored (Over/Under)
batter_hits_runs_rbis Batter hits + runs + RBIs (Over/Under)
batter_singles Batter singles (Over/Under)
batter_doubles Batter doubles (Over/Under)
batter_triples Batter triples (Over/Under)
batter_walks Batter walks (Over/Under)
batter_strikeouts Batter strikeouts (Over/Under)
batter_stolen_bases Batter stolen bases (Over/Under)
pitcher_strikeouts Pitcher strikeouts (Over/Under)
pitcher_strikeouts_alternate Alternate pitcher strikeouts (Over/Under)
pitcher_record_a_win Pitcher to record a win (Yes/No)
pitcher_hits_allowed Pitcher hits allowed (Over/Under)
pitcher_walks Pitcher walks (Over/Under)
pitcher_earned_runs Pitcher earned runs (Over/Under)
pitcher_outs Pitcher outs (Over/Under)

# NHL Player Props API

Market Key
(use in the API)
Market Name
player_points Points (Over/Under)
player_power_play_points Power play points (Over/Under)
player_assists Assists (Over/Under)
player_blocked_shots Blocked shots (Over/Under)
player_shots_on_goal Shots on goal (Over/Under)
player_goals Goals (Over/Under)
player_total_saves Total saves (Over/Under)
player_goal_scorer_first First Goal Scorer (Yes/No)
player_goal_scorer_last Last Goal Scorer (Yes/No)
player_goal_scorer_anytime Anytime Goal Scorer (Yes/No)

# Alternate NHL Player Props API

Alternate player prop markets include X+ lines, and markets labeled by bookmakers as "alternate".

Market Key
(use in the API)
Market Name
player_points_alternate Alternate Points (Over/Under)
player_assists_alternate Alternate Assists (Over/Under)
player_power_play_points_alternate Alternate Power Play Points (Over/Under)
player_goals_alternate Alternate Goals (Over/Under)
player_shots_on_goal_alternate Alternate Shots on Goal (Over/Under)
player_blocked_shots_alternate Alternate Blocked Shots (Over/Under)
player_total_saves_alternate Alternate Total Saves (Over/Under)

# AFL Player Props API

AFL player props are currently available from select AU bookmakers, including Sportsbet, Ladbrokes, TAB, Pointsbet and Betr

Market Key
(use in the API)
Market Name
player_disposals Disposals (Over/Under)
player_disposals_over Disposals (Over only)
player_goal_scorer_first First Goal Scorer (Yes/No)
player_goal_scorer_last Last Goal Scorer (Yes/No)
player_goal_scorer_anytime Anytime Goal Scorer (Yes/No)
player_goals_scored_over Goals scored (Over only)
player_marks_over Marks (Over only)
player_marks_most Most Marks (Yes/No)
player_tackles_over Tackles (Over only)
player_tackles_most Tackles (Yes/No)
player_afl_fantasy_points AFL Fantasy Points (Over/Under)
player_afl_fantasy_points_over AFL Fantasy Points (Over only)
player_afl_fantasy_points_most Most AFL Fantasy Points (Yes/No)

Suggest new markets

We are continuing to expand coverage of player props. Suggest new markets & bookmakers (opens new window).

# Get Started


To discover the sports, bookmakers and markets that we cover, the first thing you will need is an API key

Get a Free API Key →

To get started with the JSON API, see

To bring bookmaker odds into your website with a simple HTML tag, and to monetize with bookmaker affiliate links, checkout the Odds Widget

To get sports odds in Excel or Google Sheets at the click of a button (no coding needed), see