---
updatedAt: 2026-10-06T07:22:22.000Z
agentTools:
siteIndex: https://developer.sportradar.com/llms.txt
projectIndex: https://developer.sportradar.com/odds/llms.txt
---
# Competition Player Props
Returns player props for sport events in a given competition.
Note: Live player props data is not guaranteed for any competition
### Update Frequency
**TTL / Cache:** 60 seconds
**Data Updates:** Bookmaker prices refresh every 15 seconds while the event is in play
Polling cadence for this and every other feed: [Update Frequencies](https://developer.sportradar.com/odds/docs/oc-ig-update-frequencies)
> 📘 Tracking Live Odds
>
> Learn how to use the Competition Player Props feed to pull every live props board for a competition in one call in our [Tracking Live Odds](https://developer.sportradar.com/odds/docs/oc-ig-tracking-live-odds) integration scenario.
***
## Data Points
| 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](https://developer.sportradar.com/getting-started/docs/id-types#primary-ids) 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 bet
ex. `930` |
| 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` |
| 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-time | An updated timestamp if there is a delay at the start or interruption during a sport event
ex. `2024-03-26T20:00:00+00:00` |
| `start_time` | `sport_event` | Date-time | Start time of a sport event
ex. `2024-03-26T20:00:00+00:00` |
| `start_time_confirmed` | `sport_event` | Boolean | Signifies 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` |
> Markets are available by player (`players_props`) or by player market (`players_markets`).
| 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 in progress when `true` |
| `name` | `player` - `market` | String | Name of a market. Click [here](https://developer.sportradar.com/odds/reference/oc-prematch-overview#markets) 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` |
| 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` |
| 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 ouctome 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_handciap` 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) |
| `type` | `market` - `book` - `outcome` | String | Type of bet placements on a book outcome
ex. `player` |
# OpenAPI definition
```json
{
"openapi": "3.1.0",
"info": {
"title": "odds-comparison-live-odds",
"version": "2"
},
"servers": [
{
"url": "https://api.sportradar.com/oddscomparison-liveodds/"
}
],
"components": {
"securitySchemes": {
"sec0": {
"type": "apiKey",
"in": "header",
"name": "x-api-key"
}
}
},
"security": [
{
"sec0": []
}
],
"paths": {
"/{access_level}/v2/{language_code}/competitions/{competition_id}/players_props.{format}": {
"get": {
"summary": "Competition Player Props",
"description": "Returns player props for sport events in a given competition.
Note: Live player props data is not guaranteed for any competition",
"operationId": "oc-live-odds-competition-player-props",
"parameters": [
{
"name": "access_level",
"in": "path",
"description": "The access level of your API key
`trial`, `production`",
"schema": {
"type": "string",
"enum": [
"trial",
"production"
],
"default": "trial"
},
"required": true
},
{
"name": "language_code",
"in": "path",
"description": "2-letter code for supported languages
`en` (English)
English is the only fully supported language for this API. Click [here](https://api-docs.sportradar.us/misc/Sportradar_API_Languages.xlsx) for valid language codes and a tabular list of available languages per competition.",
"schema": {
"type": "string",
"default": "en"
},
"required": true
},
{
"name": "competition_id",
"in": "path",
"description": "Unique Id of a competition, found in the [Sport Competitions](https://developer.sportradar.com/odds/reference/oc-live-odds-sport-competitions) endpoint
**Examples:** `sr:competition:132` (NBA), `sr:competition:31` (NFL), `sr:competition:109` (MLB)",
"schema": {
"type": "string",
"default": "sr:competition:132"
},
"required": true
},
{
"name": "format",
"in": "path",
"description": "Format returned
`json`, `xml`",
"schema": {
"type": "string",
"enum": [
"json",
"xml"
],
"default": "json"
},
"required": true
},
{
"name": "start",
"in": "query",
"description": "The number of items to skip before starting to collect the result set.
Default: `0`
Example: `start=5`
This endpoint returns a maximum of one (1) sport event per request. Use the X-Max-Results return header to locate the number of available results.
Note: You may alternatively use `offset`",
"required": true,
"schema": {
"type": "integer",
"format": "int32",
"default": 0
}
}
],
"responses": {
"200": {
"description": "200",
"content": {
"application/json": {
"examples": {
"Result": {
"value": "{\n \"competition_sport_events_players_props\": [\n {\n \"players_markets\": {\n \"markets\": [\n {\n \"books\": [\n {\n \"external_market_id\": \"string\",\n \"external_sport_event_id\": \"string\",\n \"id\": \"string\",\n \"name\": \"string\",\n \"outcomes\": [\n {\n \"external_outcome_id\": \"string\",\n \"field_id\": \"string\",\n \"from\": 0,\n \"handicap\": \"string\",\n \"id\": \"string\",\n \"odds_american\": \"string\",\n \"odds_decimal\": \"string\",\n \"odds_fraction\": \"string\",\n \"open_handicap\": \"string\",\n \"open_odds_american\": \"string\",\n \"open_odds_decimal\": \"string\",\n \"open_odds_fraction\": \"string\",\n \"open_total\": \"string\",\n \"player_id\": \"string\",\n \"player_name\": \"string\",\n \"removed\": true,\n \"to\": 0,\n \"total\": \"string\",\n \"trend\": \"up\",\n \"type\": \"string\"\n }\n ],\n \"removed\": true\n }\n ],\n \"id\": \"string\",\n \"is_live\": true,\n \"name\": \"string\"\n }\n ]\n },\n \"players_props\": [\n {\n \"markets\": [\n {\n \"books\": [\n {\n \"external_market_id\": \"string\",\n \"external_sport_event_id\": \"string\",\n \"id\": \"string\",\n \"name\": \"string\",\n \"outcomes\": [\n {\n \"external_outcome_id\": \"string\",\n \"field_id\": \"string\",\n \"from\": 0,\n \"handicap\": \"string\",\n \"id\": \"string\",\n \"odds_american\": \"string\",\n \"odds_decimal\": \"string\",\n \"odds_fraction\": \"string\",\n \"open_handicap\": \"string\",\n \"open_odds_american\": \"string\",\n \"open_odds_decimal\": \"string\",\n \"open_odds_fraction\": \"string\",\n \"open_total\": \"string\",\n \"player_id\": \"string\",\n \"player_name\": \"string\",\n \"removed\": true,\n \"to\": 0,\n \"total\": \"string\",\n \"trend\": \"up\",\n \"type\": \"string\"\n }\n ],\n \"removed\": true\n }\n ],\n \"id\": \"string\",\n \"is_live\": true,\n \"name\": \"string\"\n }\n ],\n \"player\": {\n \"competitor_id\": \"string\",\n \"id\": \"string\",\n \"name\": \"string\"\n }\n }\n ],\n \"sport_event\": {\n \"competitors\": [\n {\n \"abbreviation\": \"string\",\n \"age_group\": \"U23\",\n \"country\": \"string\",\n \"country_code\": \"string\",\n \"gender\": \"string\",\n \"id\": \"string\",\n \"name\": \"string\",\n \"qualifier\": \"home\",\n \"rotation_number\": 0,\n \"virtual\": true\n }\n ],\n \"id\": \"sr:sport_event:134341078145277263662240842349374788382127000070788391412531731576231724560083751095084014294\",\n \"replaced_by\": \"sr:sport_event:6759466836784463030054776166098107154\",\n \"resume_time\": \"2025-01-16T18:41:28.819Z\",\n \"start_time\": \"2025-01-16T18:41:28.819Z\",\n \"start_time_confirmed\": true,\n \"status\": \"string\"\n }\n }\n ],\n \"generated_at\": \"2025-01-16T18:41:28.819Z\"\n}"
}
},
"schema": {
"type": "object",
"properties": {
"competition_sport_events_players_props": {
"type": "array",
"items": {
"type": "object",
"properties": {
"players_markets": {
"type": "object",
"properties": {
"markets": {
"type": "array",
"items": {
"type": "object",
"properties": {
"books": {
"type": "array",
"items": {
"type": "object",
"properties": {
"external_market_id": {
"type": "string",
"example": "string"
},
"external_sport_event_id": {
"type": "string",
"example": "string"
},
"id": {
"type": "string",
"example": "string"
},
"name": {
"type": "string",
"example": "string"
},
"outcomes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"external_outcome_id": {
"type": "string",
"example": "string"
},
"field_id": {
"type": "string",
"example": "string"
},
"from": {
"type": "integer",
"example": 0,
"default": 0
},
"handicap": {
"type": "string",
"example": "string"
},
"id": {
"type": "string",
"example": "string"
},
"odds_american": {
"type": "string",
"example": "string"
},
"odds_decimal": {
"type": "string",
"example": "string"
},
"odds_fraction": {
"type": "string",
"example": "string"
},
"open_handicap": {
"type": "string",
"example": "string"
},
"open_odds_american": {
"type": "string",
"example": "string"
},
"open_odds_decimal": {
"type": "string",
"example": "string"
},
"open_odds_fraction": {
"type": "string",
"example": "string"
},
"open_total": {
"type": "string",
"example": "string"
},
"player_id": {
"type": "string",
"example": "string"
},
"player_name": {
"type": "string",
"example": "string"
},
"removed": {
"type": "boolean",
"example": true,
"default": true
},
"to": {
"type": "integer",
"example": 0,
"default": 0
},
"total": {
"type": "string",
"example": "string"
},
"trend": {
"type": "string",
"example": "up"
},
"type": {
"type": "string",
"example": "string"
}
}
}
},
"removed": {
"type": "boolean",
"example": true,
"default": true
}
}
}
},
"id": {
"type": "string",
"example": "string"
},
"is_live": {
"type": "boolean",
"example": true,
"default": true
},
"name": {
"type": "string",
"example": "string"
}
}
}
}
}
},
"players_props": {
"type": "array",
"items": {
"type": "object",
"properties": {
"markets": {
"type": "array",
"items": {
"type": "object",
"properties": {
"books": {
"type": "array",
"items": {
"type": "object",
"properties": {
"external_market_id": {
"type": "string",
"example": "string"
},
"external_sport_event_id": {
"type": "string",
"example": "string"
},
"id": {
"type": "string",
"example": "string"
},
"name": {
"type": "string",
"example": "string"
},
"outcomes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"external_outcome_id": {
"type": "string",
"example": "string"
},
"field_id": {
"type": "string",
"example": "string"
},
"from": {
"type": "integer",
"example": 0,
"default": 0
},
"handicap": {
"type": "string",
"example": "string"
},
"id": {
"type": "string",
"example": "string"
},
"odds_american": {
"type": "string",
"example": "string"
},
"odds_decimal": {
"type": "string",
"example": "string"
},
"odds_fraction": {
"type": "string",
"example": "string"
},
"open_handicap": {
"type": "string",
"example": "string"
},
"open_odds_american": {
"type": "string",
"example": "string"
},
"open_odds_decimal": {
"type": "string",
"example": "string"
},
"open_odds_fraction": {
"type": "string",
"example": "string"
},
"open_total": {
"type": "string",
"example": "string"
},
"player_id": {
"type": "string",
"example": "string"
},
"player_name": {
"type": "string",
"example": "string"
},
"removed": {
"type": "boolean",
"example": true,
"default": true
},
"to": {
"type": "integer",
"example": 0,
"default": 0
},
"total": {
"type": "string",
"example": "string"
},
"trend": {
"type": "string",
"example": "up"
},
"type": {
"type": "string",
"example": "string"
}
}
}
},
"removed": {
"type": "boolean",
"example": true,
"default": true
}
}
}
},
"id": {
"type": "string",
"example": "string"
},
"is_live": {
"type": "boolean",
"example": true,
"default": true
},
"name": {
"type": "string",
"example": "string"
}
}
}
},
"player": {
"type": "object",
"properties": {
"competitor_id": {
"type": "string",
"example": "string"
},
"id": {
"type": "string",
"example": "string"
},
"name": {
"type": "string",
"example": "string"
}
}
}
}
}
},
"sport_event": {
"type": "object",
"properties": {
"competitors": {
"type": "array",
"items": {
"type": "object",
"properties": {
"abbreviation": {
"type": "string",
"example": "string"
},
"age_group": {
"type": "string",
"example": "U23"
},
"country": {
"type": "string",
"example": "string"
},
"country_code": {
"type": "string",
"example": "string"
},
"gender": {
"type": "string",
"example": "string"
},
"id": {
"type": "string",
"example": "string"
},
"name": {
"type": "string",
"example": "string"
},
"qualifier": {
"type": "string",
"example": "home"
},
"rotation_number": {
"type": "integer",
"example": 0,
"default": 0
},
"virtual": {
"type": "boolean",
"example": true,
"default": true
}
}
}
},
"id": {
"type": "string",
"example": "sr:sport_event:134341078145277263662240842349374788382127000070788391412531731576231724560083751095084014294"
},
"replaced_by": {
"type": "string",
"example": "sr:sport_event:6759466836784463030054776166098107154"
},
"resume_time": {
"type": "string",
"example": "2025-01-16T18:41:28.819Z"
},
"start_time": {
"type": "string",
"example": "2025-01-16T18:41:28.819Z"
},
"start_time_confirmed": {
"type": "boolean",
"example": true,
"default": true
},
"status": {
"type": "string",
"example": "string"
}
}
}
}
}
},
"generated_at": {
"type": "string",
"example": "2025-01-16T18:41:28.819Z"
}
}
}
}
}
}
}
}
}
},
"x-readme": {
"headers": [],
"explorer-enabled": true,
"proxy-enabled": true
},
"x-readme-fauxas": true
}
```