Skip to main content
GET
Get Historical Odds

Authorizations

apiKey
string
query
required

Your Odds-API.io API key, sent as the apiKey query parameter. Get one at https://odds-api.io/pricing.

Query Parameters

apiKey
string
required

API key for authentication

eventId
string
required

Event ID from /historical/events

bookmakers
string
required

Comma-separated list of bookmaker names (max 30)

markets
string

Comma-separated market names to return (e.g. ML,Totals). Returns all markets when omitted.

Response

OK

away
string
awayId
integer
bookmakerIds
object
bookmakers
object
date
string
home
string
homeId
integer
id
integer
league
object
scores
object
sport
object
status
string

Whether the match is under way: pending, live, settled or cancelled. Can read live before the listed start, or while /events still lists the event as pending. A pending event never carries in-play prices.

replacedBy
integer

Set only on a cancelled event that was re-issued under a new id (for example with home and away corrected): the id of the event to use instead. Omitted otherwise. A replaced event never carries odds.

Example:

72710126

urls
object