Skip to Content

Markets

Get available market types, their configurations, and sport availability.

GET /api/v1/markets

Requires an API key. Available on all tiers (Free included). Unauthenticated requests return 401.

Query ParametersPermalink for this section

All parameters are optional. With none, the response lists every market that has a current price. catalog=true lists every market, priced or not.

ParameterTypeDefaultDescription
sportstring—Only markets priced in these sports, comma-separated for several (basketball,hockey). event_count, sportsbooks and sports then cover the requested sports only.
leaguestring—Only markets priced in these leagues, comma-separated for several. Use the id from Leagues. An event that two requested leagues share counts once.
markets_onlybooleantruefalse adds coverage to every row: the sportsbooks pricing the market in each sport and league. A value that is not a boolean returns 400 with code validation_error.
catalogbooleanfalsetrue lists every market of the market list, priced or not, and adds priced to every row. See Catalog view. A value that is not a boolean returns 400 with code validation_error.

Several values in sport or league return the union, and with both parameters a market must match both. A scoped response echoes the sport and league it applied. A value with no odds live right now (or one we do not publish) is not an error: the response carries the rows for the other values, or data: [], plus a filter_warning naming it:

{ "data": [], "filter_warning": { "code": "unknown_league", "message": "no odds are live for these leagues right now, or the ids are not ones we publish; see GET /api/v1/leagues for the current list", "unknown_leagues": ["xyz"] }, "league": "xyz", "updated_at": "2026-11-09T16:40:45.488543236Z" }

For a sport the code is unknown_sport and the list is unknown_sports.

Example RequestsPermalink for this section

# List all markets curl -X GET "https://api.sharpapi.io/api/v1/markets" \ -H "X-API-Key: YOUR_API_KEY" # NBA markets only, with each league's sportsbooks curl -X GET "https://api.sharpapi.io/api/v1/markets?league=nba&markets_only=false" \ -H "X-API-Key: YOUR_API_KEY" # Every market, priced or not curl -X GET "https://api.sharpapi.io/api/v1/markets?catalog=true" \ -H "X-API-Key: YOUR_API_KEY"

ResponsePermalink for this section

Success (200)Permalink for this section

Real response, truncated to two of the market types currently returned (ordered by event_count descending):

{ "data": [ { "id": "moneyline", "name": "Moneyline", "numerical_id": 878, "event_count": 6910, "sports": ["aussie_rules", "badminton", "baseball", "basketball", "boxing", "cricket", "darts", "esports", "floorball", "football", "golf", "handball", "hockey", "mma", "rugby_league", "rugby_union", "snooker", "soccer", "table_tennis", "tennis", "volleyball"], "sportsbooks": ["ballybet", "bet365", "betfair", "betfair_lay", "betfred", "betmgm", "betonline", "betparx", "betrivers", "betsson", "betvictor", "betway", "bovada", "bwin", "caesars", "circa", "codere", "coral", "draftkings", "eighteenbet", "fanatics", "fanatics_markets", "fanduel", "fliff", "gemini", "ggbet", "goldrush", "hardrock", "kalshi", "ladbrokes", "ladbrokes_uk", "matchbook", "novig", "onexbet", "paddypower", "pinnacle", "polymarket", "prophetx", "rebet", "robinhood", "saba", "sbobet", "skybet", "smarkets", "sport888_it", "sportzino", "stake", "sx_bet", "thescorebet", "thrillzz", "unibet"] }, { "id": "2nd_half_team_total", "name": "2nd Half Team Total", "numerical_id": 331, "event_count": 42, "sports": ["basketball", "football"], "sportsbooks": ["draftkings", "fanduel", "hardrock"] } ], "updated_at": "2026-11-09T16:44:28.388212051Z" }

Market Object SchemaPermalink for this section

FieldTypeDescription
idstringMarket slug — the exact value the odds endpoints accept as market_type= (or its alias market=). See Using Markets in Filters.
namestringHuman-readable label, for display only: the market list’s label, or for a market the list does not hold yet, a name built from id. See Names. It is not a filter value — pass id instead.
numerical_idintegerStable integer key (frozen, never reused; omitted when unmapped). New (May 2026) — additive, optional. See Entity reference IDs.
event_countintegerNumber of distinct events with at least one current price in this market, across all sportsbooks, within the request’s sport / league scope. An event counts once however many sportsbooks, lines and selections price it.
sportsstring[]Sport IDs that currently have this market (with sport=, only the requested sports)
sportsbooksstring[]Sportsbook IDs with at least one current price in this market, within the request’s scope, sorted. Never null.
coverageobject[]Only with markets_only=false. See coverage.
pricedbooleanOnly with catalog=true. true when at least one sportsbook has a current price in this market within the request’s scope. See Catalog view.

coveragePermalink for this section

With markets_only=false, every row also carries coverage: the sports the market is priced in, each sport’s leagues, and the sportsbooks pricing it in each league. Sports and leagues are sorted by id, and a league id is the one Leagues returns. In a scoped request coverage holds only the requested sports and leagues. Real row from ?markets_only=false:

{ "id": "2nd_half_team_total", "name": "2nd Half Team Total", "numerical_id": 331, "event_count": 42, "sports": ["basketball", "football"], "sportsbooks": ["draftkings", "fanduel", "hardrock"], "coverage": [ { "id": "basketball", "leagues": [ { "id": "nba", "sportsbooks": ["draftkings"] }, { "id": "ncaab", "sportsbooks": ["fanduel"] } ] }, { "id": "football", "leagues": [ { "id": "nfl", "sportsbooks": ["draftkings", "fanduel", "hardrock"] } ] } ] }

A price on an event whose league we cannot identify still adds its sportsbook to the row’s sportsbooks, but it sits under no league in coverage. So a sportsbook can appear in sportsbooks without appearing in any league, and coverage is [] (never null) for a market priced only on such events.

Catalog view (catalog=true)Permalink for this section

Without catalog, the response lists only the markets that have a current price, so a market no sportsbook prices right now is missing. catalog=true lists every market of the market list, priced or not: 1,532 rows on 2026-11-11, against 673 without the flag. Every row then carries priced:

  • priced: true: at least one sportsbook has a current price in the market. The row is the same as without the flag.
  • priced: false: no sportsbook prices the market right now. event_count is 0, sports and sportsbooks are [] (never null), and with markets_only=false, coverage is [].

A priced market that the market list does not hold yet is still returned, with priced: true and no numerical_id, so the catalog view always contains every row of the response without the flag. Rows keep the usual order, event_count descending, so the unpriced markets come last, sorted by id. Real unpriced row from ?catalog=true:

{ "id": "4th_map_team_total_kills", "name": "4th Map Team Total Kills", "numerical_id": 601, "event_count": 0, "sports": [], "sportsbooks": [], "priced": false }

The market list does not say which sports or leagues a market belongs to. So with sport or league, catalog=true returns only the priced rows of that scope (the same rows as without the flag, each with priced: true), and leaves the unpriced markets out. Without the flag, or with catalog=false, the response lists only the priced markets, as before, and its rows carry no priced field.

Changed (November 2026): names come from the market listPermalink for this section

Since 2026-11-11, a market’s name is the label the market list gives it. Before, most names were built from the id, each word capitalised. 93 of the markets priced that day changed name once; id, numerical_id and every count are unchanged. Examples:

idBeforeNow
defensive_poyDefensive PoyDefensive Player of the Year
halftime_fulltimeHalftime FulltimeHalftime / Fulltime
1st_half_total_goals_odd_even1st Half Total Goals Odd Even1st Half Total Goals Odd/Even
binaryBinaryBinary (Prediction Market)

A market the list does not hold yet keeps the name built from its id. The same name is sent as market_label by Event Markets and Batch Odds, so a market has one name on every endpoint. If you match markets on name, match on id instead.

Changed (November 2026): event_count counts eventsPermalink for this section

Before 2026-11-09, event_count counted prices (every line and selection on every sportsbook), not events. It now counts each event once, so values dropped sharply: across the full catalog, point_spread went from about 110,000 to about 3,100. If you rank or filter markets on event_count, re-check your thresholds. The same release added sportsbooks and markets_only=false.

New (May 2026): numerical_idPermalink for this section

numerical_id is a frozen, dense-from-1 integer assigned per market type in the SharpAPI atlas. The market list covers about 1,530 market types (core lines + period markets + player props across all sports); catalog=true lists them all.

  • Frozen: never reused or remapped.
  • Optional: omitted for niche markets that haven’t been assigned an integer yet — slug id is always present.
  • Domain-scoped: unique across markets only.

Every odds row and opportunity leg also carries a matching market_ref block ({id, label, numerical_id}). See Entity reference IDs.

Changed (September 2026): MLB walks props are split by rolePermalink for this section

Before 2026-09-08, MLB walks props arrived under a single market id — player_walks — on most sportsbooks, whether the line was a batter’s walks drawn or a pitcher’s walks allowed. Two books used ids no other book used. Filtering market=player_walks therefore returned a mix of the two stats, and comparing that id across books could line a batter up against a pitcher.

Three market ids now carry distinct meanings:

Market idMeaning
player_walksBatter walks — bases on balls drawn at the plate
player_walks_allowedPitcher walks allowed — bases on balls issued
player_batting_walksRetired. These rows now publish as player_walks

What this means for existing integrations:

  • player_walks_allowed gained books. It previously carried Underdog only; it now also carries DraftKings and ProphetX. If you already query it, expect more rows and more cross-book comparisons on it.
  • player_walks lost pitcher rows on every book that labels the two stats distinguishably. A filter that treated every player_walks row as a batter prop is now correct on those books.
  • player_batting_walks no longer receives rows. One book published its batter walks there and now publishes them as player_walks. Query player_walks instead; a filter on the retired id returns nothing.
  • No response field changed shape, no id was removed from the /markets catalog, and nothing outside MLB walks was touched.

Known limitation — some books are still mixed. Splitting the two stats relies on the sportsbook labelling them differently in its own feed. Four books do not, so their player_walks rows still contain pitcher walks-allowed alongside batter walks: Stake, Betway, bwin and bet365 US (as of 2026-09-09). If you compare walks props across books, either exclude those four or check the player’s position on your side. This note will be updated as they are split.

Market TypesPermalink for this section

The tables below are a descriptive market reference. The Has line column describes the market type, not a field on the /markets response (the response fields are listed under Market Object Schema).

Core MarketsPermalink for this section

The most popular and widely available betting markets.

MarketDescriptionHas lineExamples
moneylinePick the winner outrightNoLakers -150, Celtics +130
point_spreadPoint spread / handicap bettingYesLakers -4.5 (-110), Celtics +4.5 (-110)
total_pointsOver/Under combined scoreYesOver 220.5 (-110), Under 220.5 (-110)
team_totalBet on one team’s scoreYesLakers Over 112.5, Lakers Under 112.5

Prop MarketsPermalink for this section

Player and game proposition bets for more specific outcomes.

MarketDescriptionHas lineExamples
player_propIndividual player statistics (points, rebounds, assists, etc.)YesLeBron James Over 25.5 Points
game_propGame-specific outcomes (will there be overtime, etc.)NoFirst Team to Score

Period MarketsPermalink for this section

Markets for specific periods within a game (halves, quarters).

MarketDescriptionHas line
1st_half1st half moneyline, spread, or totalYes
1st_quarter1st quarter moneyline, spread, or totalYes

Other MarketsPermalink for this section

MarketDescriptionHas lineExamples
futureLong-term bets on season outcomes or championshipsNoNBA Championship Winner, MVP Award Winner

Selection TypesPermalink for this section

TypeUsed InDescription
homeMoneyline, Spread, PeriodHome team wins or covers
awayMoneyline, Spread, PeriodAway team wins or covers
overTotal, Props, PeriodOver the line value
underTotal, Props, PeriodUnder the line value
yesGame Props, Team PropsOutcome occurs
noGame Props, Team PropsOutcome does not occur

Market Availability by SportPermalink for this section

SportMoneylineSpreadTotalPlayer PropsTeam PropsPeriod
Basketball (NBA)YesYesYesYesYesYes
Football (NFL)YesYesYesYesYesYes
Baseball (MLB)YesYesYesYesYesYes
Hockey (NHL)YesYesYesYesYesYes
Basketball (NCAAB)YesYesYesLimitedLimitedYes
Football (NCAAF)YesYesYesLimitedLimitedYes
SoccerYesYesYesLimitedLimitedLimited
TennisYesNoYesLimitedNoNo
MMA (UFC)YesNoNoLimitedNoNo
Golf (PGA)YesNoNoLimitedNoNo

“Limited” means the market is available for some events but not all, depending on the sportsbook and event. Use the odds endpoints to see which markets are available for a specific event.

Using Markets in FiltersPermalink for this section

Use the market id as a filter parameter on other endpoints. The odds endpoints accept it as market_type= or, equivalently, as market=. The name field is a display label — it is not a filter value.

# Get only moneyline odds curl "https://api.sharpapi.io/api/v1/odds?market=moneyline" \ -H "X-API-Key: YOUR_API_KEY" # Get spread and total odds curl "https://api.sharpapi.io/api/v1/odds?market=point_spread,total_points" \ -H "X-API-Key: YOUR_API_KEY" # Get player props only curl "https://api.sharpapi.io/api/v1/odds?market=player_prop" \ -H "X-API-Key: YOUR_API_KEY" # Best odds for moneyline markets curl "https://api.sharpapi.io/api/v1/odds/best?market=moneyline" \ -H "X-API-Key: YOUR_API_KEY"

Worked example: a /markets row to an odds queryPermalink for this section

Props are where the display name and the slug differ most, so this is where the mapping matters. Take this row from the /markets response (other fields omitted):

{ "id": "player_longest_reception", "name": "Player Longest Reception", "sports": ["football"] }

Pass the id — player_longest_reception — and not the name:

curl "https://api.sharpapi.io/api/v1/odds?market_type=player_longest_reception&league=nfl" \ -H "X-API-Key: YOUR_API_KEY"

Every row that comes back echoes the same slug in its own market_type field, so you can always go from a result back to its /markets entry.

Understanding LinesPermalink for this section

Markets that have a line include a numerical line value in the odds response:

  • Spread: The point handicap (e.g., -6.5 means the team must win by 7+)
  • Total: The combined score threshold (e.g., 215.5 for over/under)
  • Player Props: The stat threshold (e.g., 24.5 points for a player)
  • Team Props: The team stat threshold (e.g., 105.5 team total points)

Markets without a line (like moneyline) have line: null in the odds response. The /markets catalog does not say which kind a market is; read line on the odds rows themselves.

Last updated on