Markets

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

GET /api/v1/markets

Query ParametersPermalink for this section

This endpoint takes no query parameters — it always returns the full market catalog. (A sport parameter is silently ignored; filter client-side on each market’s sports array instead.)

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"

const response = await fetch('https://api.sharpapi.io/api/v1/markets', {
  headers: { 'X-API-Key': 'YOUR_API_KEY' },
});
const { data } = await response.json();
 
// List markets with event counts
data.forEach(m => {
  console.log(`${m.name} (${m.id}): ${m.event_count ?? 0} events across ${m.sports.length} sports`);
});

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']:
    events = market['event_count'] or 0
    print(f"{market['name']} ({market['id']}): {events} events across {len(market['sports'])} sports")

ResponsePermalink for this section

Success (200)Permalink for this section

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

{
  "data": [
    {
      "id": "moneyline",
      "name": "Moneyline",
      "numerical_id": 878,
      "event_count": 22608,
      "sports": ["aussie_rules", "badminton", "baseball", "basketball", "boxing", "cricket", "cycling", "darts", "entertainment", "esports", "football", "golf", "handball", "hockey", "lacrosse", "mma", "motorsports", "olympics", "politics", "rugby_league", "rugby_union", "snooker", "soccer", "table_tennis", "tennis", "unknown", "volleyball"]
    },
    {
      "id": "total_points",
      "name": "Total Points",
      "numerical_id": 1344,
      "event_count": 14852,
      "sports": ["aussie_rules", "badminton", "basketball", "darts", "esports", "football", "handball", "lacrosse", "motorsports", "olympics", "rugby_league", "rugby_union", "snooker", "unknown", "volleyball"]
    },
    {
      "id": "player_points",
      "name": "Player Points",
      "numerical_id": 1030,
      "event_count": 2090,
      "sports": ["basketball", "motorsports", "rugby_league", "soccer"]
    }
  ],
  "updated_at": "2026-07-02T18:18:04.820409247Z"
}

Market Object SchemaPermalink for this section

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 catalog covers ~3,000 canonical types (core lines + period markets + player props across all sports).

• 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.

Market TypesPermalink for this section

Core MarketsPermalink for this section

The most popular and widely available betting markets.

Prop MarketsPermalink for this section

Player and game proposition bets for more specific outcomes.

Period MarketsPermalink for this section

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

Other MarketsPermalink for this section

Selection TypesPermalink for this section

Market Availability by SportPermalink for this section

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.

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