List Odds

get

https://api.sportsstack.io/api/v1/odds

Retrieve betting odds with optimized single-query performance.

Required: At least one of league_id or event_id must be provided.

By default, returns only the latest odd per outcome/sportsbook/aggregator combination
(latest_only=true). Set latest_only=false to retrieve full historical odds data.

Use additional filters to narrow results by sportsbook, market type, etc.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

league_id

string

Filter by league ID (UUID or abbreviation, e.g., 'NFL') — required if event_id not provided

event_id

string

Filter by event ID (UUID) - required if league_id not provided

market_id

string

Filter by market ID (UUID)

outcome_id

string

Filter by outcome ID (UUID)

player_id

string

Filter by player ID (UUID) - useful for player prop markets

sportsbook

string

Filter by sportsbook name (e.g., 'draftkings', 'fanduel')

aggregator

string

Filter by aggregator (e.g., 'inside_edge', 'sportradar', 'opticodds', 'oddschecker')

market_type

string

Filter by market type (e.g., 'moneyline', 'point_spread', 'total_points')

price_type

string

Filter by price type (e.g., 'american' for priced odds, 'recommendation' for InsideEdge recommendations)

is_main

boolean

Filter by main lines only (true/false)

is_live

boolean

Filter by live odds only (true/false)

latest_only

boolean

Return only the latest odd per outcome/sportsbook/aggregator (default: true). Set to false for full historical data.

since

string

Filter odds updated since this ISO 8601 timestamp (e.g., '2026-02-11T18:00:00Z'). Only applies when latest_only=false.

count

boolean

Return an exact meta.total_count/meta.total_pages. Defaults to
true for event-scoped requests (event_id present) and false for
league-scoped requests, where counting every matching row is
unbounded. When the count is skipped both fields are null and
meta.has_next_page? drives the next link. Must be true or
false; any other value is rejected with HTTP 400.

page

integer

≥ 1

Defaults to 1

Page number for page/per_page pagination. Do not combine with limit/offset.

per_page

integer

1 to 1000

Defaults to 1000

Number of items per page (max 1000). Do not combine with limit/offset.

limit

integer

1 to 1000

Maximum rows for limit/offset pagination. Do not combine with page/per_page.

offset

integer

≥ 0

Zero-based row offset for limit/offset pagination. Do not combine with page/per_page.

Responses

Callback

200Success

400Bad Request

401Unauthorized