Event Odds

Get all odds for a specific event with optional filtering by sportsbook and market type. Returns a paginated list of odds entries.


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

This is a convenience endpoint equivalent to GET /api/v1/odds?event={eventId}. Both return the same data; use whichever fits your URL structure.

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`)

Query Parameters

Parameter	Type	Default	Description
`sportsbook`	string	all	Filter by sportsbook. Comma-separated for multiple (e.g., `draftkings,pinnacle`)
`market`	string	all	Filter by market type. Comma-separated for multiple (e.g., `moneyline,spread`)
`limit`	integer	50	Results per page (max 200)
`offset`	integer	0	Pagination offset

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

Odds Object

Field	Type	Description
`id`	string	Unique odds identifier
`sportsbook`	string	Sportsbook identifier (e.g., `draftkings`, `pinnacle`)
`event_id`	string	Parent event identifier
`market_type`	string	Market type: `moneyline`, `spread`, `total`, `player_prop`, etc.
`selection`	string	The selection (team name, player name, Over/Under)
`selection_type`	string	`home`, `away`, `over`, `under`
`line`	number \| null	Line value for spread/total markets, `null` for moneyline
`odds.american`	number	American odds (e.g., -110, +150)
`odds.decimal`	number	Decimal odds (e.g., 1.909)
`odds.probability`	number	Implied probability (e.g., 0.5238)
`timestamp`	string	ISO 8601 timestamp of when these odds were last updated

Example Requests

Get all odds for an event

cURL


curl -X GET "https://api.sharpapi.io/api/v1/events/evt_nba_bos_lal_20260208/odds" \
  -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}/odds`,
  { headers: { 'X-API-Key': 'YOUR_API_KEY' } }
);
const { data, meta } = await response.json();
console.log(`${meta.total} total odds for this event`);

Python


import requests
 
event_id = 'evt_nba_bos_lal_20260208'
response = requests.get(
    f'https://api.sharpapi.io/api/v1/events/{event_id}/odds',
    headers={'X-API-Key': 'YOUR_API_KEY'}
)
result = response.json()
print(f"{result['meta']['total']} total odds for this event")

Filter by sportsbook and market

cURL


curl -X GET "https://api.sharpapi.io/api/v1/events/evt_nba_bos_lal_20260208/odds?sportsbook=draftkings,pinnacle&market=moneyline,spread" \
  -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}/odds?sportsbook=draftkings,pinnacle&market=moneyline,spread`,
  { headers: { 'X-API-Key': 'YOUR_API_KEY' } }
);
const { data } = await response.json();

Python


import requests
 
event_id = 'evt_nba_bos_lal_20260208'
response = requests.get(
    f'https://api.sharpapi.io/api/v1/events/{event_id}/odds',
    params={
        'sportsbook': 'draftkings,pinnacle',
        'market': 'moneyline,spread'
    },
    headers={'X-API-Key': 'YOUR_API_KEY'}
)
odds = response.json()['data']

Paginate through all odds

cURL


# First page
curl -X GET "https://api.sharpapi.io/api/v1/events/evt_nba_bos_lal_20260208/odds?limit=50&offset=0" \
  -H "X-API-Key: YOUR_API_KEY"
 
# Next page
curl -X GET "https://api.sharpapi.io/api/v1/events/evt_nba_bos_lal_20260208/odds?limit=50&offset=50" \
  -H "X-API-Key: YOUR_API_KEY"

JavaScript


const eventId = 'evt_nba_bos_lal_20260208';
let offset = 0;
const limit = 50;
let allOdds = [];
 
while (true) {
  const response = await fetch(
    `https://api.sharpapi.io/api/v1/events/${eventId}/odds?limit=${limit}&offset=${offset}`,
    { headers: { 'X-API-Key': 'YOUR_API_KEY' } }
  );
  const { data, meta } = await response.json();
  allOdds = allOdds.concat(data);
 
  if (!meta.pagination.has_more) break;
  offset = meta.pagination.next_offset;
}
 
console.log(`Fetched all ${allOdds.length} odds`);

Python


import requests
 
event_id = 'evt_nba_bos_lal_20260208'
all_odds = []
offset = 0
limit = 50
 
while True:
    response = requests.get(
        f'https://api.sharpapi.io/api/v1/events/{event_id}/odds',
        params={'limit': limit, 'offset': offset},
        headers={'X-API-Key': 'YOUR_API_KEY'}
    )
    result = response.json()
    all_odds.extend(result['data'])
 
    if not result['meta']['pagination']['has_more']:
        break
    offset = result['meta']['pagination']['next_offset']
 
print(f"Fetched all {len(all_odds)} odds")

Response

Success (200)


{
  "data": [
    {
      "id": "dk_evt_nba_bos_lal_20260208_ml_home",
      "sportsbook": "draftkings",
      "event_id": "evt_nba_bos_lal_20260208",
      "market_type": "moneyline",
      "selection": "Boston Celtics",
      "selection_type": "home",
      "line": null,
      "odds": {
        "american": -180,
        "decimal": 1.556,
        "probability": 0.643
      },
      "timestamp": "2026-02-08T12:05:00Z"
    },
    {
      "id": "dk_evt_nba_bos_lal_20260208_ml_away",
      "sportsbook": "draftkings",
      "event_id": "evt_nba_bos_lal_20260208",
      "market_type": "moneyline",
      "selection": "Los Angeles Lakers",
      "selection_type": "away",
      "line": null,
      "odds": {
        "american": 155,
        "decimal": 2.55,
        "probability": 0.392
      },
      "timestamp": "2026-02-08T12:05:00Z"
    },
    {
      "id": "pin_evt_nba_bos_lal_20260208_ml_home",
      "sportsbook": "pinnacle",
      "event_id": "evt_nba_bos_lal_20260208",
      "market_type": "moneyline",
      "selection": "Boston Celtics",
      "selection_type": "home",
      "line": null,
      "odds": {
        "american": -175,
        "decimal": 1.571,
        "probability": 0.636
      },
      "timestamp": "2026-02-08T12:03:00Z"
    },
    {
      "id": "dk_evt_nba_bos_lal_20260208_spread_home",
      "sportsbook": "draftkings",
      "event_id": "evt_nba_bos_lal_20260208",
      "market_type": "spread",
      "selection": "Boston Celtics",
      "selection_type": "home",
      "line": -6.5,
      "odds": {
        "american": -110,
        "decimal": 1.909,
        "probability": 0.524
      },
      "timestamp": "2026-02-08T12:05:00Z"
    },
    {
      "id": "dk_evt_nba_bos_lal_20260208_total_over",
      "sportsbook": "draftkings",
      "event_id": "evt_nba_bos_lal_20260208",
      "market_type": "total",
      "selection": "Over",
      "selection_type": "over",
      "line": 224.5,
      "odds": {
        "american": -110,
        "decimal": 1.909,
        "probability": 0.524
      },
      "timestamp": "2026-02-08T12:05:00Z"
    }
  ],
  "meta": {
    "count": 5,
    "total": 48,
    "pagination": {
      "limit": 50,
      "offset": 0,
      "has_more": false,
      "next_offset": null
    },
    "updated_at": "2026-02-08T12:05:00Z",
    "filters": {
      "sportsbook": "all",
      "market": "all"
    }
  }
}

Error Responses

404 Not Found


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

401 Unauthorized


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

429 Rate Limited


{
  "error": {
    "code": "rate_limited",
    "message": "Rate limit exceeded. Upgrade your tier for higher limits.",
    "docs": "https://sharpapi.io/docs/pricing"
  }
}

Events - List and search events
Event Details - Get event details with embedded market data
Event Markets - List available market types for an event
Odds Snapshot - Get odds across all events
Best Odds - Get the best odds across all sportsbooks

Event Odds

Authentication

Path Parameters

Query Parameters

Response Headers

Odds Object

Example Requests

Get all odds for an event

cURL

JavaScript

Python

Filter by sportsbook and market

cURL

JavaScript

Python

Paginate through all odds

cURL

JavaScript

Python

Response

Success (200)

Error Responses

Related Endpoints