# 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 more details these markets, see examples of betting markets.

# Additional Markets BETA

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 5 minute intervals.

Due to the growing size of the API response, additional markets need to be accessed one event at a time using the new /event/{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

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).

# Player Props API Markets BETA

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 5 minute intervals.

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

# NFL 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)

# NBA + NCAAB 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_double_double Double Double (Yes/No)
player_blocks Blocks (Over/Under)
player_steals 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)

# 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)

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 and bookmakers we cover, the first thing you'll 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