Markets
Get available market types, their configurations, and sport availability.
GET /api/v1/marketsRequires 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.
| Parameter | Type | Default | Description |
|---|---|---|---|
sport | string | — | Only markets priced in these sports, comma-separated for several (basketball,hockey). event_count, sportsbooks and sports then cover the requested sports only. |
league | string | — | 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_only | boolean | true | false 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. |
catalog | boolean | false | true 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
cURL
# 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
| Field | Type | Description |
|---|---|---|
id | string | Market slug — the exact value the odds endpoints accept as market_type= (or its alias market=). See Using Markets in Filters. |
name | string | Human-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_id | integer | Stable integer key (frozen, never reused; omitted when unmapped). New (May 2026) — additive, optional. See Entity reference IDs. |
event_count | integer | Number 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. |
sports | string[] | Sport IDs that currently have this market (with sport=, only the requested sports) |
sportsbooks | string[] | Sportsbook IDs with at least one current price in this market, within the request’s scope, sorted. Never null. |
coverage | object[] | Only with markets_only=false. See coverage. |
priced | boolean | Only 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_countis0,sportsandsportsbooksare[](never null), and withmarkets_only=false,coverageis[].
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:
id | Before | Now |
|---|---|---|
defensive_poy | Defensive Poy | Defensive Player of the Year |
halftime_fulltime | Halftime Fulltime | Halftime / Fulltime |
1st_half_total_goals_odd_even | 1st Half Total Goals Odd Even | 1st Half Total Goals Odd/Even |
binary | Binary | Binary (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
idis 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 id | Meaning |
|---|---|
player_walks | Batter walks — bases on balls drawn at the plate |
player_walks_allowed | Pitcher walks allowed — bases on balls issued |
player_batting_walks | Retired. These rows now publish as player_walks |
What this means for existing integrations:
player_walks_allowedgained 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_walkslost pitcher rows on every book that labels the two stats distinguishably. A filter that treated everyplayer_walksrow as a batter prop is now correct on those books.player_batting_walksno longer receives rows. One book published its batter walks there and now publishes them asplayer_walks. Queryplayer_walksinstead; a filter on the retired id returns nothing.- No response field changed shape, no id was removed from the
/marketscatalog, 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.
| Market | Description | Has line | Examples |
|---|---|---|---|
moneyline | Pick the winner outright | No | Lakers -150, Celtics +130 |
point_spread | Point spread / handicap betting | Yes | Lakers -4.5 (-110), Celtics +4.5 (-110) |
total_points | Over/Under combined score | Yes | Over 220.5 (-110), Under 220.5 (-110) |
team_total | Bet on one team’s score | Yes | Lakers Over 112.5, Lakers Under 112.5 |
Prop MarketsPermalink for this section
Player and game proposition bets for more specific outcomes.
| Market | Description | Has line | Examples |
|---|---|---|---|
player_prop | Individual player statistics (points, rebounds, assists, etc.) | Yes | LeBron James Over 25.5 Points |
game_prop | Game-specific outcomes (will there be overtime, etc.) | No | First Team to Score |
Period MarketsPermalink for this section
Markets for specific periods within a game (halves, quarters).
| Market | Description | Has line |
|---|---|---|
1st_half | 1st half moneyline, spread, or total | Yes |
1st_quarter | 1st quarter moneyline, spread, or total | Yes |
Other MarketsPermalink for this section
| Market | Description | Has line | Examples |
|---|---|---|---|
future | Long-term bets on season outcomes or championships | No | NBA Championship Winner, MVP Award Winner |
Selection TypesPermalink for this section
| Type | Used In | Description |
|---|---|---|
home | Moneyline, Spread, Period | Home team wins or covers |
away | Moneyline, Spread, Period | Away team wins or covers |
over | Total, Props, Period | Over the line value |
under | Total, Props, Period | Under the line value |
yes | Game Props, Team Props | Outcome occurs |
no | Game Props, Team Props | Outcome does not occur |
Market Availability by SportPermalink for this section
| Sport | Moneyline | Spread | Total | Player Props | Team Props | Period |
|---|---|---|---|---|---|---|
| Basketball (NBA) | Yes | Yes | Yes | Yes | Yes | Yes |
| Football (NFL) | Yes | Yes | Yes | Yes | Yes | Yes |
| Baseball (MLB) | Yes | Yes | Yes | Yes | Yes | Yes |
| Hockey (NHL) | Yes | Yes | Yes | Yes | Yes | Yes |
| Basketball (NCAAB) | Yes | Yes | Yes | Limited | Limited | Yes |
| Football (NCAAF) | Yes | Yes | Yes | Limited | Limited | Yes |
| Soccer | Yes | Yes | Yes | Limited | Limited | Limited |
| Tennis | Yes | No | Yes | Limited | No | No |
| MMA (UFC) | Yes | No | No | Limited | No | No |
| Golf (PGA) | Yes | No | No | Limited | No | No |
“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.5means the team must win by 7+) - Total: The combined score threshold (e.g.,
215.5for over/under) - Player Props: The stat threshold (e.g.,
24.5points for a player) - Team Props: The team stat threshold (e.g.,
105.5team 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.
Related EndpointsPermalink for this section
- Odds Snapshot - Filter odds by market type
- Best Odds - Best odds filtered by market
- Sports - See which sports are available
- Sportsbooks - See which books support which markets