---
updatedAt: 2025-12-10T20:44:12.000Z
agentTools:
siteIndex: https://developer.sportradar.com/llms.txt
projectIndex: https://developer.sportradar.com/odds/v1/llms.txt
---
# Sport Event Markets
Returns a list of markets and odds for a given match.
### Update Frequency
60s Time To Live / Cache
***
## Data Points
| 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` |
| 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` |
> Competitors may be teams or players. Each will appear with unique competitor IDs (`sr:competitor:xxxx`).
| 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) |
| `country` | `sport_event` - `competitors` - `competitor` | String | Country name of a competitor
ex. `USA` |
| `country` | `sport_event` - `competitors` - `competitor` | String | Country code of a competitor
ex. `USA` |
| `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` |
| `uuids` | `sport_event` - `competitors` - `competitor` | String | Unique UUID(s) of a competitor
ex. `ef64da7f-cfaf-4300-87b0-9313386b977c`
Click [here](https://developer.sportradar.com/getting-started/docs/id-types#primary-ids) for more info on Sportradar IDs |
| Attribute | Parent Element | Type | Description |
| ------------------ | ------------------------ | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `end_date` | `sport_event` - `season` | Date | End date of a sport event's season
ex. `2024-11-03` |
| `id` | `sport_event` - `season` | UID | Unique SR ID of a sport event's season
ex. `sr:season:112588`
Click [here](https://developer.sportradar.com/getting-started/docs/id-types#primary-ids) for more info on Sportradar IDs |
| `name` | `sport_event` - `season` | String | Name of a sport event's season
ex. `MLB 2024` |
| `start_date` | `sport_event` - `season` | Date | Start date of a sport event's season
ex. `2024-03-20` |
| `tournament_id` | `sport_event` - `season` | UID | Unique SR ID of a sport event's season tournament
ex. `sr:tournament:109`
Click [here](https://developer.sportradar.com/getting-started/docs/id-types#primary-ids) for more info on Sportradar IDs |
| `tournament_uuids` | `sport_event` - `season` | String | Unique UUID of a sport event's season tournament(s)
ex. `2ea6efe7-2e21-4f29-80a2-0a24ad1f5f85,2fa448bc-fc17-4d3d-be03-e60e080fdc26`
Click [here](https://developer.sportradar.com/getting-started/docs/id-types#primary-ids) for more info on Sportradar IDs |
| `uuids` | `sport_event` - `season` | String | Unique UUID(s) of a sport event's season
ex. `6a5c278f-ebce-41f9-b1ba-2160b6af04ce,f23888ed-6ca7-45bf-99e1-24b7393f540c`
Click [here](https://developer.sportradar.com/getting-started/docs/id-types#primary-ids) for more info on Sportradar IDs |
| `year` | `sport_event` - `season` | Integer | Year of a sport event's season
ex. `2024` |
| Attribute | Parent Element | Type | Description |
| --------- | ---------------------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id` | `sport_event` - `tournament` | UID | Unique SR ID of a sport event's tournament
ex. `sr:tournament:109`
Click [here](https://developer.sportradar.com/getting-started/docs/id-types#primary-ids) for more info on Sportradar IDs |
| `name` | `sport_event` - `tournament` | String | Name of a sport event's tournament
ex. `MLB` |
| `type` | `sport_event` - `tournament` | String | Type of a sport event's tournament |
| `uuids` | `sport_event` - `tournament` | String | Unique UUID(s) of a sport event's tournament
ex. `2ea6efe7-2e21-4f29-80a2-0a24ad1f5f85,2fa448bc-fc17-4d3d-be03-e60e080fdc26`
Click [here](https://developer.sportradar.com/getting-started/docs/id-types#primary-ids) for more info on Sportradar IDs |
| 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` |
| 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 match is postponed and played at a later date
ex. `sr:sport_event:47395897` |
| `scheduled` | `sport_event` | Date | Scheduled start time of a sport event
ex. `2024-03-26T20:00:00+00:00` |
| `start_time_tbd` | `sport_event` | Boolean | Signifies the start time of a sport event is TBD (to be determined) when `true` |
| `status` | `sport_event` | String | Status of a sport event
ex. `not_started`,`closed`, `live` |
| `uuids` | `sport_event` | String | Unique UUID(s) of a sport event
ex. `f644dde6-39cc-434f-8758-18da232dc4ec`
Click [here](https://developer.sportradar.com/getting-started/docs/id-types#primary-ids) for more info on Sportradar IDs |
| 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](https://developer.sportradar.com/odds/reference/oc-regular-overview#available-markets) 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` |
| Attribute | Parent Element | Type | Description |
| ---------------- | ----------------------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `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) |
| `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` |
| 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` |
| 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` markets
ex. `-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` |
| Attribute | Parent Element | Type | Description |
| ----------------- | -------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `capacity` | `venue` | Integer | Capacity of a venue
ex. `60000` |
| `city_name` | `venue` | String | City name of a venue
ex. `Liverpool` |
| `country_code` | `venue` | String | Country code of a venue
ex. `ENG` (England) |
| `country_name` | `venue` | String | Country name of a venue
ex. `England` |
| `id` | `venue` | String | Unique ID of a venue
ex. `sr:venue:579` |
| `map_coordinates` | `venue` | String | Coordinates of a venue
ex. `53.430622,-2.960919` |
| `name` | `venue` | String | Name of a venue
ex. `Anfield` |
| `uuids` | `venue` | String | Unique UUID of a venue
ex. `f3690068-b967-4335-9182-69c3554f8de2`
Click [here](https://developer.sportradar.com/getting-started/docs/id-types#primary-ids) for more info on Sportradar IDs |
# OpenAPI definition
```json
{
"openapi": "3.1.0",
"info": {
"title": "sportradar-api",
"version": "2"
},
"servers": [
{
"url": "https://api.sportradar.com/"
}
],
"components": {
"securitySchemes": {
"sec0": {
"type": "apiKey",
"in": "header",
"name": "x-api-key"
}
}
},
"security": [
{
"sec0": []
}
],
"paths": {
"/oddscomparison-{package_type}{access_level}1/{language_code}/{odds_format}/sport_events/{sport_event_id}/markets.{format}": {
"get": {
"summary": "Sport Event Markets",
"description": "Returns a list of markets and odds for a given match.",
"operationId": "oc-regular-sport-event-markets",
"parameters": [
{
"name": "package_type",
"in": "path",
"description": "Odds package type, with configured bookmakers prominent in either the US or global markets
`us` (United States), `row` (Rest of World)",
"schema": {
"type": "string",
"enum": [
"us",
"row"
],
"default": "us"
},
"required": true
},
{
"name": "access_level",
"in": "path",
"description": "The access level of your API key
`t` (Trial), `p` (Production)",
"schema": {
"type": "string",
"enum": [
"t",
"p"
],
"default": "t"
},
"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": "odds_format",
"in": "path",
"description": "Odds type in 2-letter format
`us` (American), `uk` (Fractional), `eu` (Decimal)",
"schema": {
"type": "string",
"enum": [
"us",
"uk",
"eu"
],
"default": "us"
},
"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\": \"2023-10-18T19:09:16+00:00\",\n \"schema\": \"https://schemas.sportradar.com/sportsapi/bsa/oddscomparison/v1/schemas/sport_event_markets.json\",\n \"sport_event\": {\n \"id\": \"sr:match:41945881\",\n \"scheduled\": \"2023-10-17T08:30:00+00:00\",\n \"start_time_tbd\": false,\n \"status\": \"cancelled\",\n \"tournament_round\": {\n \"type\": \"group\",\n \"number\": 1\n },\n \"season\": {\n \"id\": \"sr:season:69330\",\n \"name\": \"World Cup 2023\",\n \"start_date\": \"2023-10-05\",\n \"end_date\": \"2023-11-20\",\n \"year\": \"2023\",\n \"tournament_id\": \"sr:tournament:2474\"\n },\n \"tournament\": {\n \"id\": \"sr:tournament:2474\",\n \"name\": \"World Cup\",\n \"type\": \"t10\",\n \"sport\": {\n \"id\": \"sr:sport:21\",\n \"name\": \"Cricket\"\n },\n \"category\": {\n \"id\": \"sr:category:105\",\n \"name\": \"International\"\n }\n },\n \"competitors\": [\n {\n \"id\": \"sr:competitor:142708\",\n \"name\": \"South Africa\",\n \"country\": \"South Africa\",\n \"country_code\": \"ZAF\",\n \"abbreviation\": \"SA\",\n \"qualifier\": \"home\"\n },\n {\n \"id\": \"sr:competitor:142700\",\n \"name\": \"Netherlands\",\n \"country\": \"Netherlands\",\n \"country_code\": \"NLD\",\n \"abbreviation\": \"NED\",\n \"qualifier\": \"away\"\n }\n ],\n \"venue\": {\n \"id\": \"sr:venue:25136\",\n \"name\": \"Himachal Pradesh Cricket Association Stadium\",\n \"capacity\": 23000,\n \"city_name\": \"Dharamsala\",\n \"country_name\": \"India\",\n \"map_coordinates\": \"32.197672,76.325997\",\n \"country_code\": \"IND\"\n },\n \"markets\": [\n {\n \"odds_type_id\": 1,\n \"name\": \"2way\",\n \"group_name\": \"regular\",\n \"books\": [\n {\n \"id\": \"sr:book:18149\",\n \"name\": \"DraftKings\",\n \"outcomes\": [\n {\n \"odds_field_id\": 2,\n \"type\": \"away\",\n \"odds\": \"+900\",\n \"opening_odds\": \"+1100\",\n \"odds_trend\": \"down\"\n }\n ]\n }\n ]\n }\n ],\n \"markets_last_updated\": \"2023-10-17T08:06:40+00:00\",\n \"consensus\": {\n \"lines\": [\n {\n \"name\": \"moneyline_current\",\n \"outcomes\": [\n {\n \"type\": \"home\",\n \"odds\": \"-1975\"\n },\n {\n \"type\": \"away\",\n \"odds\": \"+900\"\n }\n ]\n }\n ]\n }\n }\n}"
}
},
"schema": {
"type": "object",
"properties": {
"generated_at": {
"type": "string",
"example": "2023-10-18T19:09:16+00:00"
},
"schema": {
"type": "string",
"example": "https://schemas.sportradar.com/sportsapi/bsa/oddscomparison/v1/schemas/sport_event_markets.json"
},
"sport_event": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "sr:match:41945881"
},
"scheduled": {
"type": "string",
"example": "2023-10-17T08:30:00+00:00"
},
"start_time_tbd": {
"type": "boolean",
"example": false,
"default": true
},
"status": {
"type": "string",
"example": "cancelled"
},
"tournament_round": {
"type": "object",
"properties": {
"type": {
"type": "string",
"example": "group"
},
"number": {
"type": "integer",
"example": 1,
"default": 0
}
}
},
"season": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "sr:season:69330"
},
"name": {
"type": "string",
"example": "World Cup 2023"
},
"start_date": {
"type": "string",
"example": "2023-10-05"
},
"end_date": {
"type": "string",
"example": "2023-11-20"
},
"year": {
"type": "string",
"example": "2023"
},
"tournament_id": {
"type": "string",
"example": "sr:tournament:2474"
}
}
},
"tournament": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "sr:tournament:2474"
},
"name": {
"type": "string",
"example": "World Cup"
},
"type": {
"type": "string",
"example": "t10"
},
"sport": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "sr:sport:21"
},
"name": {
"type": "string",
"example": "Cricket"
}
}
},
"category": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "sr:category:105"
},
"name": {
"type": "string",
"example": "International"
}
}
}
}
},
"competitors": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "sr:competitor:142708"
},
"name": {
"type": "string",
"example": "South Africa"
},
"country": {
"type": "string",
"example": "South Africa"
},
"country_code": {
"type": "string",
"example": "ZAF"
},
"abbreviation": {
"type": "string",
"example": "SA"
},
"qualifier": {
"type": "string",
"example": "home"
}
}
}
},
"venue": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "sr:venue:25136"
},
"name": {
"type": "string",
"example": "Himachal Pradesh Cricket Association Stadium"
},
"capacity": {
"type": "integer",
"example": 23000,
"default": 0
},
"city_name": {
"type": "string",
"example": "Dharamsala"
},
"country_name": {
"type": "string",
"example": "India"
},
"map_coordinates": {
"type": "string",
"example": "32.197672,76.325997"
},
"country_code": {
"type": "string",
"example": "IND"
}
}
},
"markets": {
"type": "array",
"items": {
"type": "object",
"properties": {
"odds_type_id": {
"type": "integer",
"example": 1,
"default": 0
},
"name": {
"type": "string",
"example": "2way"
},
"group_name": {
"type": "string",
"example": "regular"
},
"books": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "sr:book:18149"
},
"name": {
"type": "string",
"example": "DraftKings"
},
"outcomes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"odds_field_id": {
"type": "integer",
"example": 2,
"default": 0
},
"type": {
"type": "string",
"example": "away"
},
"odds": {
"type": "string",
"example": "+900"
},
"opening_odds": {
"type": "string",
"example": "+1100"
},
"odds_trend": {
"type": "string",
"example": "down"
}
}
}
}
}
}
}
}
}
},
"markets_last_updated": {
"type": "string",
"example": "2023-10-17T08:06:40+00:00"
},
"consensus": {
"type": "object",
"properties": {
"lines": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"example": "moneyline_current"
},
"outcomes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string",
"example": "home"
},
"odds": {
"type": "string",
"example": "-1975"
}
}
}
}
}
}
}
}
}
}
}
}
}
}
}
}
},
"deprecated": false
}
}
},
"x-readme": {
"headers": [],
"explorer-enabled": true,
"proxy-enabled": true
},
"x-readme-fauxas": true
}
```