Competition Player Props

Time	Status	User Agent
Retrieving recent requests…

⏱️
Update Frequency
TTL / Cache: 60 seconds
Data Updates: As prop odds move; bookmaker prices refresh once per minute
Polling cadence for this and every other feed: Update Frequencies

📘
Retrieving Player Props
Learn how to use the Competition Player Props feed to batch props by competition in our Retrieving Player Props integration scenario.

📘
Pagination Note
Pagination will often be required to pull all data within this feed. By default, the feed will return 1 sport event.

Data Points

Competitor

Attribute	Parent Element	Type	Description
`abbreviation`	`sport_event` - `competitors` - `competitor`	String	Abbreviated name of a competitor ex. `LOS` (Los Angeles Dodgers) or `HAA` (Haaland, Erling Braut)
`age_group`	`sport_event` - `competitors` - `competitor`	String	Age group of a competitor, when applicable ex. `U23`
`country`	`sport_event` - `competitors` - `competitor`	String	Country name of a competitor ex. `USA`
`country_code`	`sport_event` - `competitors` - `competitor`	String	Country code of a competitor ex. `USA`
`gender`	`sport_event` - `competitors` - `competitor`	String	Gender for a competitor `male`, `female`
`id`	`sport_event` - `competitors` - `competitor`	String	Unique SR ID of a competitor ex. `sr:competitor:3638` Click here for more info on Sportradar IDs
`name`	`sport_event` - `competitors` - `competitor`	String	Name of a competitor ex. `Los Angeles Dodgers` or `Haaland, Erling Braut`
`qualifier`	`sport_event` - `competitors` - `competitor`	String	Signifies a competitor as the home or away team ex. `home`, `away`
`rotation_number`	`sport_event` - `competitors` - `competitor`	Integer	Rotation number of a competitor's bet ex. `930`

Player

Attribute	Parent Element	Type	Description
`id`	`player_props` - `player`	String	Unique SR ID of a player ex. `sr:player:607346`
`name`	`player_props` - `player`	String	Name of a competitor ex. `Morris, Markieff`
`competitor_id`	`player_props` - `player`	String	Unique SR ID of a player's team ex. `sr:competitor:3411`

Sport Event

Attribute	Parent Element	Type	Description
`id`	`sport_event`	String	Unique SR ID of a sport event ex. `sr:sport_event:47395897`
`replaced_by`	`sport_event`	String	An alternative sport event ID if the sport event is postponed and played at a later date ex. `sr:sport_event:47395897`
`resume_time`	`sport_event`	Date	An updated timestamp if there is a delay at the start or an interruption during a sport event ex. `2024-03-26T20:00:00+00:00`
`start_time`	`sport_event`	Date	Start time of a sport event ex. `2024-03-26T20:00:00+00:00`
`start_time_confirmed`	`sport_event`	Boolean	Signifies that the start time of a sport event is confirmed when `true`
`status`	`sport_event`	String	Status of a sport event ex. `not_started`, `2nd_half`, `ended`, `awaiting_penalties`, `overtime`

Market

Attribute	Parent Element	Type	Description
`id`	`player` - `market`	GUID	Unique ID of a market ex. `sr:market:1`
`is_live`	`player` - `market`	Boolean	Signifies a market's sport event is live when `true`
`name`	`player` - `market`	String	Name of a market. Click here for a complete list of available markets and their IDs ex. `total points (incl. overtime)`, `total assists (incl. overtime)`, `to score 3 or more touchdowns`

Books

Attribute	Parent Element	Type	Description
`external_market_id`	`player` - `market` - `book`	GUID	Unique market ID used by the bookmaker. Leverage this ID to create deeplinking ex. `16243440`
`external_sport_event_id`	`player` - `market` - `book`	GUID	Unique sport event ID used by the bookmaker. Leverage this ID to create deeplinking ex. `1159662682`
`id`	`player` - `market` - `book`	GUID	Unique ID of a sportsbook for a market ex. `sr:book:18186`
`name`	`player` - `market` - `book`	String	Name of a sportsbook for a market ex. `FanDuel`
`removed`	`player` - `market` - `book`	String	Signifies a book market has been removed when `true`

Market Outcome

Attribute	Parent Element	Type	Description
`external_outcome_id`	`market` - `book` - `outcome`	GUID	Unique outcome ID used by the bookmaker. Leverage this ID to create deeplinking ex. `28012b67-3564-35a4-a42e-066a80dea8cb`
`field_id`	`market` - `book` - `outcome`	GUID	Identifier for the outcome type ex. `1` & `2` for `home` & `away`. `3`, `4`, & `5` for `home`, `draw`, & `away`
`handicap`	`market` - `book` - `outcome`	String	Handicap value of a book outcome. Used for `handicap` and `asian_handicap` markets ex. `-1` (home) and `1` (away) or `-1.5` (home) and `1.5` (away)
`id`	`market` - `book` - `outcome`	GUID	Unique ID of an outcome ex. `sr:outcome:12`
`odds_american`	`market` - `book` - `outcome`	String	American odds value of a book outcome ex. `-161`
`odds_decimal`	`market` - `book` - `outcome`	String	Decimal odds value of a book outcome ex. `1.620`
`odds_fraction`	`market` - `book` - `outcome`	String	Fractional odds value of a book outcome ex. `8/13`
`open_odds_american`	`market` - `book` - `outcome`	String	Opening American odds value of a book outcome ex. `-161`
`open_odds_decimal`	`market` - `book` - `outcome`	String	Opening decimal odds value of a book outcome ex. `1.620`
`open_odds_fraction`	`market` - `book` - `outcome`	String	Opening fractional odds value of a book outcome ex. `8/13`
`open_total`	`market` - `book` - `outcome`	String	Opening total odds value of a book outcome ex. `24.5`
`open_handicap`	`market` - `book` - `outcome`	String	Opening handicap odds value of a book outcome ex. `-0.5`
`player_id`	`market` - `book` - `outcome`	String	Unique player ID for a book outcome. ex. `sr:player:2795673`
`player_name`	`market` - `book` - `outcome`	String	Player name for a book outcome. ex. `DeJean, Cooper`
`removed`	`market` - `book` - `outcome`	Boolean	Signifies an outcome has been removed when `true`
`total`	`market` - `book` - `outcome`	Double	Total line of a book outcome ex. `8.5` (Baseball runs), `-65.5` (Football points)
`trend`	`market` - `book` - `outcome`	String	Odds trending value of a book outcome ex. `down`, `up`
`type`	`market` - `book` - `outcome`	String	Type of bet placements on a book outcome ex. `player`

Update Frequency

Retrieving Player Props

Pagination Note

Data Points

200