sportradar.comSportradar Support Portal

Sport Structure

Betradar categorizes the sports events by the type of sport, the country or region in which it takes place, the series (tournament) it belongs to, the season it is played, and the teams or players inv

Hierarchical Classification of Matches and Outrights

The order of classification is different for different sports. UOF supports 3 different hierarchy structures, and the one used mainly depends on the type of sport.

The following diagram gives an overview of the matches/competitions (outrights) are classified:

Note:

  • A `sport` (1) can have any number of categories (*) associated with it but a category must have one and only one sport associated with it.

  • A season (0/1) can have 0 or 1 competitions (outrights) associated with it.

  • A stage might have any number of other stages associated with it (*)

Matches and competitions both inherit from events (we offer odds on)

Sport Hierarchy

Please note that in the following illustrations,

  • Outrights mean 'outright markets' are offered at the specified level and Markets, simply mean 'match markets'.

  • The terms Outrights and Competitions are used synonymously.

Tournament Structure

Figure below provides a good overview:

Tournament Structure

The Tournament is in most cases the recurrent competition.

The Season is the yearly periodical edition of the competition.

The Tournament_round can be a Group, a Cup or a Qualification. The three of them are also classified as simple tournaments which can be seen as micro tournament inside the season.

1. Season Structure

Sports with 2 competitors (e.g. soccer, basketball, etc) usually use a "season" hierarchy

Sport → Category → Tournament → Season → Round (implicit) → Match

Season Structure

2. Stages Structure

Sports with more than 2 competitors (F1, bikes, cycling, etc) use a "stage" hierarchy

Sport → Category → Tournament → Stages → Competition

Stages Structure

3. Simple Tournament Structure

  • In some cases, mostly when there is only limited information about a given competition, the competition is represented with a "simple_tournament". This can be used regardless of the sport.

Sport→ Category → Simple_tournament → Match

Simple Tournament Structure

Events and Definitions

Sport

Sport stands at the top of the hierarchial order. Betradar offers odds for a wide range of sports like Baseball, Basketball, Tennis, Soccer, Football, etc. Use this endpoint for the list of all available sports.

Category

The Sports are further categorized by the name of the country/region in which the sporting event takes place.

The second highest level of classification for sports hierarchy is Category. The categories available are different for different sports. For example, for soccer, the categories are typically countries, but for tennis, the categories are the different tours: ATP, WTA, ITF, and so on. Use this endpoint for the list of available categories for a sport.

Tournament

Tounaments are a series of matches that take place to determine a sole winner. This is best explained by example: “Bundesliga” is the tournament. “Bundesliga 16/17” is a season of “Bundesliga”. Use this endpoint for the list of all available tournaments.

Season

A match typically happens within a season of a recurring tournament/competition (e.g. Bundesliga 2016/17 or Wimbledon, Men Singles, 2017). In other words, a season is an incarnation of the tournament in a given year and the tournament itself is a competition that possibly re-occurs year after year, each year crowning a new winner. Use this endpoint to get all available seasons for a specific tournament

Simple Tournament

A sport tournament either reflects a given season, with fairly good start/end dates or a reoccuring tournament with start/end dates going across multiple years.

Stage

Stages are used to model more complex sport structure than the standard `season` format. For example in winter sports, it can model relationships like an event being both part of the olympics and the regular world cup. Sports such as formula 1 / wintersport often use this structure.

A stage would always be of a particular type. The type can be things like discipline (like mens single), season (like formula 1 2023), qualification/race or an event.

Match

A sport event between two competitors happening at a certain time at a certain place

  • Parent & Child Matches: The overall (parent) match up which consists of multiple child matches. This concept is used in competitions where there is a one overall match up (parent match) that isn't actually played but the score is made up from the results of other matches (child matches). E.g. Tennis Fed Cup (tie and rubber) where nations match up is a parent match and matches between the athletes from those nations are child matches. Each victory in child match contributes a point to the score of parent match.

  • Match vs Competition: Match refers to a specific sport event where two players/teams compete against each other. For example, Tennis, Basketball, Football, Icehockey etc where as competition refers to a specific sport event where multiple individual competitors (players) who compete against each other. For example, Formula1 or Golf

Competition

Either a single sport event between more than 2 teams/competitors, or a longer tournament with more competitors. e.g. tennis doubles is still considered a match between two different teams/competitors

PreviousKey ConceptsNextSport Event Information

Last updated

Was this helpful?