Skip to Content
API ReferenceMarkets

Markets

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

GET /api/v1/markets

This is a public endpoint — no authentication required. Unauthenticated requests are rate-limited to 10 requests/minute. Authenticated requests receive your tier’s full rate limit.

Query Parameters

ParameterTypeDefaultDescription
sportstringallFilter markets by sport (e.g., basketball)

Example Requests

# List all markets (no auth required)
curl -X GET "https://api.sharpapi.io/api/v1/markets"
 
# Filter by sport
curl -X GET "https://api.sharpapi.io/api/v1/markets?sport=basketball"

Response

Success (200)

{
  "data": [
    {
      "id": "moneyline",
      "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",
      "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",
      "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 Schema

FieldTypeDescription
idstringUnique market identifier (use in API filters)
namestringHuman-readable market name
descriptionstringBrief description of the market
hasLinebooleanWhether this market includes a line value
examplesstring[]Example selections for this market
event_countnumber | nullNumber of events currently offering this market
selection_countnumber | nullNumber of unique selections across all events
sportsstring[]Sport IDs that currently have this market

Market Types

Core Markets

The most popular and widely available betting markets.

MarketDescriptionhasLineExamples
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 Markets

Player and game proposition bets for more specific outcomes.

MarketDescriptionhasLineExamples
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 Markets

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

MarketDescriptionhasLine
1st_half1st half moneyline, spread, or totalYes
1st_quarter1st quarter moneyline, spread, or totalYes

Other Markets

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

Selection Types

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 Sport

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 Filters

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 Lines

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.

Last updated on
SportsbooksOdds Snapshot