Event Details

Get detailed information for a single event, including available markets and metadata.


GET /api/v1/events/{eventId}

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

Event Detail Object

Field	Type	Description
`id`	string	Canonical event identifier — the same for every sportsbook covering this event. Use as your primary key for cross-book matching. See Event Matching.
`external_ids`	object	Map of sportsbook ID to that book’s native event ID (e.g., `{ "draftkings": "12345", "fanduel": "67890" }`). Use these for deep linking back to sportsbook pages.
`sport`	string	Sport identifier (e.g., `basketball`, `football`)
`league`	string	League name (e.g., `NBA`, `NFL`)
`home_team`	string	Home team name
`away_team`	string	Away team name
`start_time`	string	ISO 8601 event start time
`status`	string	Event status: `upcoming`, `live`, `final`, `postponed`, `cancelled`
`is_live`	boolean	Whether the event is currently live
`books`	array	Sportsbooks covering this event, sorted by market count descending
`markets`	array	Market types available for this event, sorted by selection count descending

Books Array

Each entry in the books array describes a sportsbook that has odds for this event.

Field	Type	Description
`id`	string	Sportsbook identifier (e.g., `draftkings`, `pinnacle`)
`name`	string	Display name of the sportsbook
`market_count`	integer	Number of distinct market types this book offers for the event
`last_update`	string	ISO 8601 timestamp of the most recent odds update from this book

Markets Array

Each entry in the markets array summarizes an available market type for this event.

Field	Type	Description
`type`	string	Market type identifier (e.g., `moneyline`, `spread`, `total`, `player_prop`)
`selection_count`	integer	Number of distinct selections available in this market
`book_count`	integer	Number of sportsbooks offering this market

Example Requests

cURL


curl -X GET "https://api.sharpapi.io/api/v1/events/evt_nba_bos_lal_20260208" \
  -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}`,
  { headers: { 'X-API-Key': 'YOUR_API_KEY' } }
);
const { data, meta } = await response.json();
console.log(`${data.home_team} vs ${data.away_team}`);
console.log(`Markets: ${data.markets.map(m => m.type).join(', ')}`);

Python


import requests
 
event_id = 'evt_nba_bos_lal_20260208'
response = requests.get(
    f'https://api.sharpapi.io/api/v1/events/{event_id}',
    headers={'X-API-Key': 'YOUR_API_KEY'}
)
event = response.json()['data']
print(f"{event['home_team']} vs {event['away_team']}")
print(f"Markets: {[m['type'] for m in event['markets']]}")

Response

Success (200)

Single-resource responses wrap the object in data as a single object (not an array).


{
  "data": {
    "id": "evt_nba_bos_lal_20260208",
    "external_ids": {
      "draftkings": "12345678",
      "fanduel": "87654321",
      "pinnacle": "556677889",
      "betmgm": "ms_44556"
    },
    "sport": "basketball",
    "league": "NBA",
    "home_team": "Boston Celtics",
    "away_team": "Los Angeles Lakers",
    "start_time": "2026-02-08T19:30:00Z",
    "status": "upcoming",
    "is_live": false,
    "books": [
      {
        "id": "draftkings",
        "name": "DraftKings",
        "market_count": 5,
        "last_update": "2026-02-08T12:05:00Z"
      },
      {
        "id": "fanduel",
        "name": "FanDuel",
        "market_count": 4,
        "last_update": "2026-02-08T12:04:30Z"
      },
      {
        "id": "pinnacle",
        "name": "Pinnacle",
        "market_count": 3,
        "last_update": "2026-02-08T12:03:00Z"
      },
      {
        "id": "betmgm",
        "name": "BetMGM",
        "market_count": 3,
        "last_update": "2026-02-08T12:02:15Z"
      }
    ],
    "markets": [
      {
        "type": "moneyline",
        "selection_count": 2,
        "book_count": 4
      },
      {
        "type": "spread",
        "selection_count": 2,
        "book_count": 4
      },
      {
        "type": "total",
        "selection_count": 2,
        "book_count": 3
      },
      {
        "type": "player_prop",
        "selection_count": 18,
        "book_count": 2
      },
      {
        "type": "team_total",
        "selection_count": 4,
        "book_count": 1
      }
    ]
  },
  "meta": {
    "event_id": "evt_nba_bos_lal_20260208"
  }
}

Error Responses

404 Not Found


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

401 Unauthorized


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

Use Cases

Cross-book comparison — The canonical id is the same across all sportsbooks, so all odds returned are already matched to the same real-world event. See Event Matching.
Market analysis — See every available market type and how many books offer each
Sharp reference — Compare soft book odds against Pinnacle (the sharp benchmark)
Deep linking — Use external_ids to link users to a specific sportsbook’s event page

Events - List and search events
Event Odds - Get paginated odds for this event
Event Markets - Get available market types for this event
Odds Snapshot - Get current odds across all events