---
updatedAt: 2026-10-06T07:22:58.000Z
agentTools:
siteIndex: https://developer.sportradar.com/llms.txt
projectIndex: https://developer.sportradar.com/odds/llms.txt
---
# Sport Event Markets
Returns markets for a given sport event.
### Update Frequency
**TTL / Cache:** 1 second
**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 Sport Event Markets feed to follow a live board from the pre-game board to the final, including suspended books and the closing line, 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` | `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` |
| Attribute | Parent Element | Type | Description |
|-----------|----------------|--------|-------------|
| `id` | `market` | GUID | Unique ID of a market
ex. `sr:market:1` |
| `is_live` | `market` | Boolean| Signifies a market's sport event is live when `true` |
| `name` | `market` | String | Name of a market
ex. `1st half - 1x2`, `winning margin`, `will there be overtime`, `total`, `handicap` |
| Attribute | Parent Element | Type | Description |
| --------- | -------------- | ---- | ----------- |
| `external_market_id` | `market` - `book` | GUID | Unique market ID used by the bookmaker. Leverage this ID to create deeplinking
ex. `16243440` |
| `external_sport_event_id` | `market` - `book` | GUID | Unique sport event ID used by the bookmaker. Leverage this ID to create deeplinking
ex. `1159662682` |
| `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` |
| 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. `0QA221647684#87306987_13L88808Q1929653Q21` |
| `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_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:1714` |
| `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:2169312`
*This is used exclusively for the **Player Props** and **Futures** odds API* |
| `player_name` | `market` - `book` - `outcome` | String | Player name for a book outcome.
ex. `Brown, Antario`
*This is used exclusively for the **Player Props** and **Futures** odds API* |
| `removed` | `market` - `book` - `outcome` | Boolean | Signifies an outcome has been removed when `true` |
| `spread` | `market` - `book` - `outcome` | Double | Spread line of a book outcome
ex. `-1.5` (Baseball runs), `-17` (Football points) |
| `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. `home` or `away` |
# 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}/sport_events/{sport_event_id}/sport_event_markets.{format}": {
"get": {
"summary": "Sport Event Markets",
"description": "Returns markets for a given sport event.",
"operationId": "oc-live-odds-sport-event-markets",
"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": "sport_event_id",
"in": "path",
"description": "Unique Id of a sport event
**Example:** `sr:sport_event:56930759`",
"schema": {
"type": "string",
"default": "sr:sport_event:60574971"
},
"required": true
},
{
"name": "format",
"in": "path",
"description": "Format returned
`json`, `xml`",
"schema": {
"type": "string",
"enum": [
"json",
"xml"
],
"default": "json"
},
"required": true
}
],
"responses": {
"200": {
"description": "200",
"content": {
"application/json": {
"examples": {
"Result": {
"value": "{\n \"generated_at\": \"2025-01-16T17:10:50.869Z\",\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 \"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:0092499291343218547428046580336544639153304224087546006336914762\",\n \"replaced_by\": \"sr:sport_event:650409113950141523228438284433060422485890\",\n \"resume_time\": \"2025-01-16T17:10:50.869Z\",\n \"start_time\": \"2025-01-16T17:10:50.869Z\",\n \"start_time_confirmed\": true,\n \"status\": \"string\"\n }\n}"
}
},
"schema": {
"type": "object",
"properties": {
"generated_at": {
"type": "string",
"example": "2025-01-16T17:10:50.869Z"
},
"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"
}
}
}
},
"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:0092499291343218547428046580336544639153304224087546006336914762"
},
"replaced_by": {
"type": "string",
"example": "sr:sport_event:650409113950141523228438284433060422485890"
},
"resume_time": {
"type": "string",
"example": "2025-01-16T17:10:50.869Z"
},
"start_time": {
"type": "string",
"example": "2025-01-16T17:10:50.869Z"
},
"start_time_confirmed": {
"type": "boolean",
"example": true,
"default": true
},
"status": {
"type": "string",
"example": "string"
}
}
}
}
}
}
}
}
}
}
}
},
"x-readme": {
"headers": [],
"explorer-enabled": true,
"proxy-enabled": true
},
"x-readme-fauxas": true
}
```