Event Markets

Get the available market types for a specific event, including how many sportsbooks offer each market.


GET /api/v1/events/{eventId}/markets

Authentication

Requires API key via X-API-Key header, Authorization: Bearer header, or api_key query param. Available to all tiers.

Path Parameters

Parameter	Type	Required	Description
`eventId`	string	Yes	Unique event identifier (e.g., `evt_nba_bos_lal_20260208`)

Response Headers

All responses include standard rate limit and metadata headers:

Header	Description
`X-RateLimit-Limit`	Maximum requests per minute for your tier
`X-RateLimit-Remaining`	Requests remaining in current window
`X-RateLimit-Reset`	Unix timestamp when the rate limit window resets
`X-Data-Delay`	Data delay for your tier (e.g., `0s`, `60s`)
`X-Request-Id`	Unique request identifier for debugging

Market Object

Field	Type	Description
`type`	string	Market type identifier (e.g., `moneyline`, `point_spread`, `total_points`)
`selection_count`	integer	Number of distinct selections within this market
`book_count`	integer	Number of sportsbooks offering this market
`selections`	array	List of Selection objects for this market

Selection Object

Field	Type	Description
`name`	string	Selection name (e.g., `Boston Celtics`, `Over`, `LeBron James`)
`type`	string	Selection type (e.g., `home`, `away`, `over`, `under`)
`line`	number	Point spread or total line value. Omitted for markets without lines (e.g., moneyline).
`book_count`	integer	Number of sportsbooks offering this selection

Example Requests

cURL


curl -X GET "https://api.sharpapi.io/api/v1/events/evt_nba_bos_lal_20260208/markets" \
  -H "X-API-Key: YOUR_API_KEY"

JavaScript


const eventId = 'evt_nba_bos_lal_20260208';
const response = await fetch(
  `https://api.sharpapi.io/api/v1/events/${eventId}/markets`,
  { headers: { 'X-API-Key': 'YOUR_API_KEY' } }
);
const { data, meta } = await response.json();
 
// List markets and their selections
for (const market of data) {
  console.log(`${market.type}: ${market.book_count} books, ${market.selection_count} selections`);
  for (const sel of market.selections) {
    console.log(`  ${sel.name} (${sel.type}): ${sel.book_count} books${sel.line !== undefined ? `, line ${sel.line}` : ''}`);
  }
}

Python


import requests
 
event_id = 'evt_nba_bos_lal_20260208'
response = requests.get(
    f'https://api.sharpapi.io/api/v1/events/{event_id}/markets',
    headers={'X-API-Key': 'YOUR_API_KEY'}
)
result = response.json()
 
for market in result['data']:
    print(f"{market['type']}: {market['book_count']} books, {market['selection_count']} selections")
    for sel in market['selections']:
        line_info = f", line {sel['line']}" if 'line' in sel else ''
        print(f"  {sel['name']} ({sel['type']}): {sel['book_count']} books{line_info}")

Response

Success (200)


{
  "success": true,
  "data": [
    {
      "type": "moneyline",
      "selection_count": 2,
      "book_count": 6,
      "selections": [
        { "name": "Boston Celtics", "type": "home", "book_count": 6 },
        { "name": "Los Angeles Lakers", "type": "away", "book_count": 6 }
      ]
    },
    {
      "type": "point_spread",
      "selection_count": 2,
      "book_count": 6,
      "selections": [
        { "name": "Boston Celtics", "type": "home", "line": -5.5, "book_count": 6 },
        { "name": "Los Angeles Lakers", "type": "away", "line": 5.5, "book_count": 6 }
      ]
    },
    {
      "type": "total_points",
      "selection_count": 2,
      "book_count": 6,
      "selections": [
        { "name": "Over", "type": "over", "line": 220.5, "book_count": 6 },
        { "name": "Under", "type": "under", "line": 220.5, "book_count": 6 }
      ]
    },
    {
      "type": "team_total",
      "selection_count": 4,
      "book_count": 4,
      "selections": [
        { "name": "Boston Celtics Over", "type": "over", "line": 113.5, "book_count": 4 },
        { "name": "Boston Celtics Under", "type": "under", "line": 113.5, "book_count": 4 },
        { "name": "Los Angeles Lakers Over", "type": "over", "line": 106.5, "book_count": 3 },
        { "name": "Los Angeles Lakers Under", "type": "under", "line": 106.5, "book_count": 3 }
      ]
    },
    {
      "type": "player_prop",
      "selection_count": 24,
      "book_count": 4,
      "selections": [
        { "name": "LeBron James Over", "type": "over", "line": 25.5, "book_count": 4 },
        { "name": "LeBron James Under", "type": "under", "line": 25.5, "book_count": 4 },
        { "name": "Jayson Tatum Over", "type": "over", "line": 28.5, "book_count": 3 },
        { "name": "Jayson Tatum Under", "type": "under", "line": 28.5, "book_count": 3 }
      ]
    }
  ],
  "meta": {
    "event_id": "evt_nba_bos_lal_20260208",
    "count": 5,
    "updated_at": "2026-02-08T12:05:00Z"
  }
}

Error Responses

404 Not Found


{
  "error": {
    "code": "not_found",
    "message": "Event not found",
    "docs": "https://sharpapi.io/docs/api-reference/events-markets"
  }
}

401 Unauthorized


{
  "error": {
    "code": "unauthorized",
    "message": "Missing or invalid API key",
    "docs": "https://sharpapi.io/docs/authentication"
  }
}

Use Cases

Market discovery — Determine which market types are available before requesting odds, reducing unnecessary API calls
Sportsbook coverage — See which sportsbooks cover each market to identify comparison opportunities
Line shopping prep — Identify markets offered by multiple books where you can shop for the best line
Player props availability — Check if player prop markets are available (often limited to certain books and closer to game time)

Use this endpoint to check market availability before calling Event Odds with a market filter. This avoids wasting API calls on market types that do not exist for a given event.

Events - List and search events
Event Details - Get event details with embedded market data
Event Odds - Get all odds for this event
Markets - List all market types across the platform