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

Parameter	Type	Default	Description
`sport`	string	all	Filter markets by sport (e.g., `basketball`)

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"
 
# Filter by sport
curl -X GET "https://api.sharpapi.io/api/v1/markets?sport=basketball" \
  -H "X-API-Key: YOUR_API_KEY"

JavaScript


const response = await fetch('https://api.sharpapi.io/api/v1/markets', {
  headers: { 'X-API-Key': 'YOUR_API_KEY' },
});
const { data, meta } = await response.json();
 
// List markets with event counts
data.forEach(m => {
  const lineInfo = m.hasLine ? 'has line' : 'no line';
  console.log(`${m.name} (${m.id}): ${lineInfo}, ${m.event_count ?? 0} events`);
  if (m.examples.length) console.log(`  Examples: ${m.examples.join(', ')}`);
});

Python


import requests
 
response = requests.get(
    'https://api.sharpapi.io/api/v1/markets',
    headers={'X-API-Key': 'YOUR_API_KEY'},
)
result = response.json()
 
for market in result['data']:
    line_info = "has line" if market['hasLine'] else "no line"
    events = market['event_count'] or 0
    print(f"{market['name']} ({market['id']}): {line_info}, {events} events")
    if market['examples']:
        print(f"  Examples: {', '.join(market['examples'])}")

ResponsePermalink for this section

Success (200)Permalink for this section


{
  "data": [
    {
      "id": "moneyline",
      "numerical_id": 878,
      "name": "Moneyline",
      "description": "Bet on which team will win the game outright",
      "hasLine": false,
      "examples": ["Lakers -150", "Celtics +130"],
      "event_count": 142,
      "selection_count": 312,
      "sports": ["baseball", "basketball", "football", "hockey", "mma", "soccer", "tennis"]
    },
    {
      "id": "point_spread",
      "numerical_id": 880,
      "name": "Point Spread",
      "description": "Bet on the point margin between teams",
      "hasLine": true,
      "examples": ["Lakers -4.5 (-110)", "Celtics +4.5 (-110)"],
      "event_count": 98,
      "selection_count": 210,
      "sports": ["baseball", "basketball", "football", "hockey"]
    },
    {
      "id": "total_points",
      "numerical_id": 881,
      "name": "Total Points",
      "description": "Bet on the combined score of both teams (over/under)",
      "hasLine": true,
      "examples": ["Over 220.5 (-110)", "Under 220.5 (-110)"],
      "event_count": 95,
      "selection_count": 198,
      "sports": ["baseball", "basketball", "football", "hockey", "soccer", "tennis"]
    },
    {
      "id": "team_total",
      "name": "Team Total",
      "description": "Bet on the score of one specific team",
      "hasLine": true,
      "examples": ["Lakers Over 112.5", "Lakers Under 112.5"],
      "event_count": 64,
      "selection_count": 140,
      "sports": ["baseball", "basketball", "football", "hockey"]
    },
    {
      "id": "player_prop",
      "name": "Player Prop",
      "description": "Bet on individual player performance statistics",
      "hasLine": true,
      "examples": ["LeBron James Over 25.5 Points", "Stephen Curry Over 4.5 3-Pointers"],
      "event_count": 52,
      "selection_count": 1840,
      "sports": ["baseball", "basketball", "football", "hockey"]
    },
    {
      "id": "game_prop",
      "name": "Game Prop",
      "description": "Bet on specific game events or occurrences",
      "hasLine": false,
      "examples": ["First Team to Score", "Will there be Overtime?"],
      "event_count": 30,
      "selection_count": 86,
      "sports": ["baseball", "basketball", "football", "hockey"]
    },
    {
      "id": "future",
      "name": "Future",
      "description": "Long-term bets on season outcomes or championships",
      "hasLine": false,
      "examples": ["NBA Championship Winner", "MVP Award Winner"],
      "event_count": 12,
      "selection_count": 48,
      "sports": ["baseball", "basketball", "football", "hockey"]
    },
    {
      "id": "1st_half",
      "name": "1st Half",
      "description": "1st Half",
      "hasLine": true,
      "examples": [],
      "event_count": 40,
      "selection_count": 96,
      "sports": ["basketball", "football"]
    },
    {
      "id": "1st_quarter",
      "name": "1st Quarter",
      "description": "1st Quarter",
      "hasLine": true,
      "examples": [],
      "event_count": 28,
      "selection_count": 64,
      "sports": ["basketball", "football"]
    }
  ],
  "meta": {
    "count": 9,
    "total_events": 561,
    "total_selections": 2994,
    "rate_limit": {
      "limit": 10,
      "remaining": 9,
      "reset": 1706270460
    }
  }
}

Market Object SchemaPermalink for this section

Field	Type	Description
`id`	string	Unique market identifier (use in API filters)
`numerical_id`	integer \| null	Stable integer key for the market type (frozen, never reused). New (May 2026) — additive, optional. See Entity reference IDs.
`name`	string	Human-readable market name
`description`	string	Brief description of the market
`hasLine`	boolean	Whether this market includes a line value
`examples`	string[]	Example selections for this market
`event_count`	number \| null	Number of events currently offering this market
`selection_count`	number \| null	Number of unique selections across all events
`sports`	string[]	Sport IDs that currently have this market

New (May 2026): `numerical_id`Permalink for this section

numerical_id is a frozen, dense-from-1 integer assigned per market type in the SharpAPI atlas. The market catalog covers ~3,000 canonical types (core lines + period markets + player props across all sports).

Frozen: never reused or remapped.
Optional: absent (or null) 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.

Market TypesPermalink for this section

Core MarketsPermalink for this section

The most popular and widely available betting markets.

Market	Description	hasLine	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	hasLine	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	hasLine
`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	hasLine	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:


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

Understanding LinesPermalink for this section

Markets with hasLine: true 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 with hasLine: false (like moneyline) will have line: null in the odds response.

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