Betting markets available through the API
Use normalized bet_type, metric, and period fields for match prices, spreads, totals, team markets, and player props.
Featured betting markets
These seven normalized bet_type values form the base of the sports odds contract.
| Market | API bet_type |
What it covers |
|---|---|---|
| Match winner | moneyline |
Two-outcome home and away prices, including player-versus-player events. |
| Three-way match result | moneyline 3w |
Home, draw, and away prices for sports where a draw is a valid result. |
| Point spread or handicap | handicap |
Main and alternate lines applied to a team, player, score, or sport-specific metric. |
| Game total | total |
Over and under lines for a game, match, period, set, or innings window. |
| Team total | team total |
Over and under lines for one team's score or another team-level metric. |
| Player prop | player prop |
Player totals, milestones, scorer markets, and performance statistics. |
| Win margin | big win little win |
A source-specific winning-margin market where the bookmaker supplies it. |
How market fields work
A market is a combination of type, metric, period, side, and lineānot one bookmaker-specific label.
Availability depends on the bookmaker, sport, league, event, and time. Check the current event response before relying on a specific combination.
{
"bookmaker": "tab",
"bet_type": "player prop",
"metric": "player points",
"period_str": "full time",
"player_name": "Example Player",
"line": "25.5",
"selection_name": "Over 25.5",
"odds": 1.91
}
Game and team metrics
Combine these 38 metric values with the listed bet_type families.
| Market | API metric |
Used with bet_type |
|---|---|---|
| Aces | aces |
team totaltotal
|
| Behinds | behinds |
handicapteam totaltotal
|
| Breaks of serve | breaks of serve |
team totaltotal
|
| Cards | cards |
team totaltotal
|
| Corners | corners |
handicapmoneylinemoneyline 3wteam totaltotal
|
| Double faults | double faults |
team totaltotal
|
| Field goal yards | field goal yards |
total
|
| Field goals | field goals |
team totaltotal
|
| Fours | fours |
team totaltotal
|
| Games | games |
handicapteam totaltotal
|
| Goals | goals |
team totaltotal
|
| Hits | hits |
handicapteam totaltotal
|
| Home runs | home runs |
total
|
| Legs | legs |
handicap
|
| Behinds | player behinds |
team total
|
| Earned runs | player earned runs |
total
|
| Hits | player hits |
total
|
| Steals + blocks | player steals + blocks |
team total
|
| Tries | player tries |
total
|
| Power play goals | power play goals |
team total
|
| Punts | punts |
total
|
| Rounds | rounds |
total
|
| Runs | runs |
handicapteam totaltotal
|
| Rushing touchdown | rushing touchdown |
total
|
| Sack | sack |
total
|
| Sets | sets |
handicapteam totaltotal
|
| Shots | shots |
team totaltotal
|
| Shots on target | shots on target |
team totaltotal
|
| Sixes | sixes |
total
|
| Standard player market | standard |
big win little winhandicapmoneylinemoneyline 3wteam totaltotal
|
| Tackles | tackles |
team total
|
| Three pointers | three pointers |
team total
|
| Tie breaks | tie breaks |
total
|
| Touchdown yards | touchdown yards |
moneylineteam totaltotal
|
| Touchdowns | touchdowns |
moneylineteam totaltotal
|
| Tries | tries |
handicapteam totaltotal
|
| Turnovers | turnovers |
total
|
| Yards | yards |
total
|
Game period markets
Current normalized coverage includes 25 full-time, period, set, and innings values.
Match and game periods
Full games, halves, quarters, and sport periods
| Period | API period_str |
|---|---|
| Full Time | full time |
| 1st Half | 1st half |
| 2nd Half | 2nd half |
| 1st Quarter | 1st quarter |
| 2nd Quarter | 2nd quarter |
| 3rd Quarter | 3rd quarter |
| 4th Quarter | 4th quarter |
| 1st Period | 1st period |
| 2nd Period | 2nd period |
| 3rd Period | 3rd period |
Sets
Tennis and other set-based events
| Period | API period_str |
|---|---|
| 1st Set | 1st set |
| 2nd Set | 2nd set |
Baseball innings
Single innings and shortened game windows
| Period | API period_str |
|---|---|
| 1st Inning | 1st inning |
| 2nd Inning | 2nd inning |
| 3rd Inning | 3rd inning |
| 4th Inning | 4th inning |
| 5th Inning | 5th inning |
| 6th Inning | 6th inning |
| 7th Inning | 7th inning |
| 8th Inning | 8th inning |
| 9th Inning | 9th inning |
| 3 Innings | 3 innings |
| 5 Innings | 5 innings |
| 7 Innings | 7 innings |
| 1st 5 Innings | 1st 5 innings |
Player prop API markets
One hundred normalized player metrics cover totals, milestones, scorer markets, and performance statistics.
Scoring and general player markets
Goals, points, field goals, scorer markets, tries, and touchdowns.
| Market | API metric |
|---|---|
| Goals | goals |
| Assists | player assists |
| Field goals | player field goals |
| Goals | player goals |
| Points | player points |
| Power play goals | player power play goals |
| Score and assist | player score and assist |
| Score or assist | player score or assist |
| Touchdowns | player touchdowns |
| Tries | player tries |
| Receiving touchdowns | receiving touchdowns |
| Standard player market | standard |
| Successful extra points | successful extra points |
| Touchdowns | touchdowns |
| Extra points | player extra points |
| Kicking points | player kicking points |
| First try scorer | player first try scorer |
| Last try scorer | player last try scorer |
| Threes | player threes |
| 3-point field goals | player 3pt field goals |
Basketball stat combinations
Rebounds, defensive statistics, turnovers, and combined stat lines.
| Market | API metric |
|---|---|
| Blocks | player blocks |
| Double doubles | player double doubles |
| Points + assists | player pa |
| Points + rebounds | player pr |
| Points + rebounds + assists | player pra |
| Rebounds + assists | player ra |
| Rebounds | player rebounds |
| Steals | player steals |
| Steals + blocks | player steals + blocks |
| Turnovers + steals + blocks | player tos + steals + blocks |
| Triple doubles | player triple doubles |
| Turnovers | player turnovers |
Passing, receiving and rushing
Attempts, completions, yardage, touchdowns, receptions, and longest-play lines.
| Market | API metric |
|---|---|
| Interceptions | player interceptions |
| Interceptions thrown | player interceptions thrown |
| Longest pass | player longest pass |
| Longest pass yards | player longest pass yards |
| Longest reception | player longest reception |
| Longest reception yards | player longest reception yards |
| Longest rush | player longest rush |
| Longest rush yards | player longest rush yards |
| Pass attempts | player pass attempts |
| Pass completions | player pass completions |
| Passing + rushing yards | player passing + rushing yards |
| Passing touchdowns | player passing touchdowns |
| Passing yards | player passing yards |
| Receiving yards | player receiving yards |
| Receptions | player receptions |
| Rush attempts | player rush attempts |
| Rushing + receiving yards | player rushing + receiving yards |
| Rushing attempts | player rushing attempts |
| Rushing touchdowns | player rushing touchdowns |
| Rushing yards | player rushing yards |
| Sack | player sack |
| Tackles + tackle assists | player tackles + tackle assists |
| Thrown + rushing touchdowns | player thrown + rushing touchdowns |
| Thrown touchdowns | player thrown touchdowns |
| Total passing + rushing yards | player total passing + rushing yards |
| Total receptions | player total receptions |
| Total rushing + receiving yards | player total rushing + receiving yards |
Baseball batting and pitching
Hits, bases, runs, RBIs, strikeouts, walks, and pitcher outcomes.
| Market | API metric |
|---|---|
| Batter strikeouts | player batter strikeouts |
| Double | player double |
| Earned runs | player earned runs |
| Hits | player hits |
| Hits allowed | player hits allowed |
| Hits + runs + RBIs | player hits, runs and rbis |
| Home runs | player home runs |
| Pitcher strikeouts | player pitcher strikeouts |
| RBIs | player rbi |
| Runs | player runs |
| Single | player single |
| Stolen bases | player stolen bases |
| Total bases | player total bases |
| Triple | player triple |
| Walks | player walks |
| Walks allowed | player walks allowed |
AFL, rugby, soccer and tennis actions
Disposals, marks, tackles, passing, shots, tries, and set markets.
| Market | API metric |
|---|---|
| Assists + tackles | player assists + tackles |
| Behinds | player behinds |
| Clearances | player clearances |
| Disposals | player disposals |
| Handballs | player handballs |
| Header | player header |
| Kicks | player kicks |
| Marks | player marks |
| Passes | player passes |
| Performance | player performance |
| Set wins | player set wins |
| Shots | player shots |
| Shots on target | player shots on target |
| Tackles | player tackles |
| Total games | player total games |
Pick'em player markets
Normalized pick'em metrics supplied by supported sources.
| Market | API metric |
|---|---|
| Pick'em disposals | pickem player disposals |
| Pick'em fantasy | pickem player fantasy |
| Pick'em goals | pickem player goals |
| Pick'em marks | pickem player marks |
| Pick'em performance | pickem player performance |
| Pick'em points | pickem player points |
| Pick'em points combined | pickem player points combined |
| Pick'em SuperCoach | pickem player supercoach |
| Pick'em tackles | pickem player tackles |
| Pick'em tries | pickem player tries |
Request current markets
Find an event, request its odds snapshot, then filter the response or stream by documented market fields.
curl --request GET \
--header "X-API-Key: $ODDS_API_KEY" \
"https://api.odds-api.net/v1/events/$EVENT_ID/odds/snapshot?types=player%20prop"
Betting markets FAQs
Market fields, filtering, availability, periods, and streaming.
How does odds-api represent betting markets?
Each odds row uses a normalized bet_type, metric, and period_str. Depending on the market, the row can also include side, line, player_name, selection_name, bookmaker, and freshness fields.
Can I filter an odds request by betting market?
Yes. Snapshot, history, and streaming endpoints support market filters where documented. Use the types filter for normalized bet_type values and market_keys for the available market keys returned by the API.
Does every bookmaker provide every betting market?
No. Market availability depends on the bookmaker, sport, league, event, and time. Check the current event snapshot or coverage catalogue before relying on a specific market.
Which player props does the API capture?
Current parser coverage contains 100 normalized player-prop metrics across scoring, basketball combinations, passing, receiving, rushing, baseball, AFL, rugby, soccer, tennis, and pick'em markets.
Are first-half, quarter, period, set, and innings markets included?
Yes. Current normalized period values cover full time, halves, quarters, hockey periods, tennis sets, individual baseball innings, and shortened innings windows where supplied.
Can betting-market prices be streamed?
Supported events can move from a REST snapshot to SSE or WebSocket updates. The same normalized market fields are retained across snapshots and streams.
Request your first market.
Create an API key, choose an event, and load its current odds.