Returns a list of sport events for a given sport ID and date that have odds available.
Update Frequency60s Time To Live / Cache
Pagination NotePagination will often be required to pull all data within this feed. By default, the feed will return 100 sport events.
Data Points
Books:
Attribute | Parent Element | Type | Description |
---|---|---|---|
id | market - book | GUID | Unique ID of a sportsbook for a market ex. sr:book:18186 |
name | market - book | String | Name of a sportsbook for a market ex. FanDuel |
removed | market - book | String | Signifies a book market has been removed when true |
Sport & Category:
Attribute | Parent Element | Type | Description |
---|---|---|---|
country_code | sport_event - tournament - category | String | Country code of a category for a sport event ex. USA (USA, MLB) |
id | sport_event - tournament - category | GUID | Unique ID of a category for a sport event ex. sr:category:16 (MLB) |
name | sport_event - tournament - category | String | Name of a category for a sport event ex. USA |
id | (sport_event - tournament ) - sport | GUID | Unique ID of a sport ex. sr:sport:3 (Baseball) |
name | (sport_event - tournament ) - sport | String | Name of a sport ex. Baseball |
Competitor:
Competitors may be teams or players. Each will appear with unique competitor IDs (
sr:competitor:xxxx
).
Attribute | Parent Element | Type | Description |
---|---|---|---|
|
| String | Abbreviated name of a competitor |
|
| String | Country name of a competitor |
|
| String | Country code of a competitor |
|
| String | Unique SR ID of a competitor |
|
| String | Name of a competitor |
|
| String | Signifies a competitor as the home or away team |
|
| Integer | Rotation number of a competitor bet |
|
| String | Unique UUID(s) of a competitor |
Season:
Attribute | Parent Element | Type | Description |
---|---|---|---|
|
| Date | End date of a sport event's season |
|
| UID | Unique SR ID of a sport event's season |
|
| String | Name of a sport event's season |
|
| Date | Start date of a sport event's season |
|
| UID | Unique SR ID of a sport event's season tournament |
|
| String | Unique UUID of a sport event's season tournament(s) |
|
| String | Unique UUID(s) of a sport event's season |
|
| Integer | Year of a sport event's season |
Tournament:
Attribute | Parent Element | Type | Description |
---|---|---|---|
|
| UID | Unique SR ID of a sport event's tournament |
|
| String | Name of a sport event's tournament |
|
| String | Type of a sport event's tournament |
|
| String | Unique UUID(s) of a sport event's tournament |
Tournament Round:
Attribute | Parent Element | Type | Description |
---|---|---|---|
cup_round_match_number | sport_event - tournament_round | Integer | Round match number of a sport event's tournament round |
cup_round_matches | sport_event - tournament_round | Integer | Number of matches in a sport event's tournament round |
group | sport_event - tournament_round | String | Group name of a sport event's tournament round ex. Pacific League |
name | sport_event - tournament_round | String | Name of a sport event's tournament round ex. semifinal , round_of_16 |
number | sport_event - tournament_round | Integer | Round number of a sport event's tournament round |
other_match_id | sport_event - tournament_round | UID | A linked sport event ID, typically in a two-legged tie ex. sr:sport_event:47395897 |
phase | sport_event - tournament_round | String | Phase of a sport event's tournament round ex. regular season |
tournament_match_number | sport_event - tournament_round | Integer | Tournament match number of a sport event's tournament round |
type | sport_event - tournament_round | String | Type of a sport event's tournament round ex. cup , group |
Sport Event:
Attribute | Parent Element | Type | Description |
---|---|---|---|
|
| String | Unique SR ID of a sport event |
|
| String | An alternative sport event ID if the match is postponed and played at a later date |
|
| Date | Scheduled start time of a sport event |
|
| Boolean | Signifies the start time of a sport event is TBD (to be determined) when |
|
| String | Status of a sport event |
|
| String | Unique UUID(s) of a sport event |
Market:
Attribute | Parent Element | Type | Description |
---|---|---|---|
group_name | markets - market | String | Group name of a market ex. regular |
name | markets - market | String | Name of a market. Click here for a complete list of available markets and their IDs ex. 2way , 3way , total , run_line , handicap , asian_handicap , first_team_to_score , 1x2_half_time |
odds_type_id | markets - market | Integer | ID for a type of market |
last_updated | markets | Date | Timestamp of the last update to markets ex. 2024-08-29T03:10:12+00:00 |
Market Outcome:
Attribute | Parent Element | Type | Description |
---|---|---|---|
handicap | market - book - outcome | String | Handicap value of a book outcome. Used for handicap and asian_handciap marketsex. -1 (home) and 1 (away) or -1.5 (home) and 1.5 (away) |
odds | market - book - outcome | String | Odds value of a book outcome ex. -105 (us), 1.952 (eu), 119/125 (uk) |
odds_field_id | market - book - outcome | Integer | Identifier for the ouctome type ex. 1 & 2 for home & away . 3 , 4 , & 5 for home , draw , & away |
odds_trend | market - book - outcome | String | Odds trending value of a book outcome ex. down , up |
opening_odds | market - book - outcome | String | Opening odds value of a book outcome ex. -105 (us), 1.952 (eu), 119/125 (uk) |
opening_spread | market - book - outcome | Number | Opening spread line of a book outcome ex. -1.5 (Baseball runs), -17 (Football points) |
opening_total | market - book - outcome | Number | Opening total line of a book outcome ex. 8.5 (Baseball runs), -65.5 (Football points) |
spread | market - book - outcome | String | Spread line of a book outcome ex. -1.5 (Baseball runs), -17 (Football points) |
total | market - book - outcome | String | Total line of a book outcome ex. 8.5 (Baseball runs), -65.5 (Football points) |
type | market - book - outcome | String | Type of bet placements on a book outcome ex. home or away |
Consensus Bet Percentage:
Attribute | Parent Element | Type | Description |
---|---|---|---|
name | consensus - bet_percentage_outcomes - market | String | Name of a bet percentage market. ex. moneyline , run_line , total , spread |
percentage | consensus - bet_percentage_outcomes - market - outcome | Number | Percentage of bet placements on a market outcome ex. 47 (home) & 53 (away) |
type | consensus - bet_percentage_outcomes - market - outcome | String | Type of bet placements on a market outcome ex. home or away |
Consensus Lines:
Attribute | Parent Element | Type | Description |
---|---|---|---|
name | consensus - lines - line | String | Name of a consensus line market. ex. moneyline_current , moneyline_open , run_line_current , run_line_open , total_current , total_open , asian_handicap_current , asian_handicap_open |
handicap | consensus - lines - line | String | Handicap value of a consensus line outcome. Used for handicap and asian_handciap marketsex. -1 or 1 |
spread | consensus - lines - line | String | Spread line of a consensus line outcome ex. -1.5 (Baseball runs), -17 (Football points) |
total | consensus - lines - line | Number | Total line of a consensus line outcome ex. 8.5 (Baseball runs), -65.5 (Football points) |
odds | consensus - lines - line - outcome | String | Odds value of bet placements on a consensus line outcome ex. -105 (us), 1.952 (eu), 119/125 (uk) |
total | consensus - lines - line - outcome | Number | Total line of a consensus line outcome ex. 8.5 (Baseball runs), -65.5 (Football points) |
type | consensus - lines - line - outcome | String | Type of bet placements on a consensus line outcome ex. home or away |
Venue:
Attribute | Parent Element | Type | Description |
---|---|---|---|
|
| Integer | Capacity of a venue |
|
| String | City name of a venue |
|
| String | Country code of a venue |
|
| String | Country name of a venue |
|
| String | Unique ID of a venue |
|
| String | Coordinates of a venue |
|
| String | Name of a venue |
|
| String | Unique UUID of a venue |