Table of contents: Match meta information messages contain the general information about a match. This message gets sent out by Betradar on
the following occasions: • When a match becomes available;
• When a match becomes unavailable;
• When parameters change (e.g. start time of the match). Additionally, match meta information messages can be requested by the client system by sending a meta request. To make sure that the client system has the most recent match meta information, it is recommended to send meta requests periodically, and update possible changes in the client system. Standard meta information message: The standard meta information message contains the date and time of the match, sport, category, tournament, teams and what TV-channels this match is broadcasted. | Code Block |
|---|
| language | xml |
|---|
| title | XML example |
|---|
| <BetradarLiveOdds timestamp="1184145290125" xmlns="http://www.betradar.com/BetradarLiveOdds" status="meta" >
<Match active="1" matchid="505484" status="not_started">
<MatchInfo>
<DateOfMatch>1184175000000</DateOfMatch>
<Sport id="1">Soccer</Sport>
<Category id="17">Austria</Category>
<Tournament id="29">T-Mobile Bundesliga</Tournament>
<HomeTeam id="6589" uniqueid="2051">SK PUNTIGAMER STURM GRAZ</HomeTeam>
<AwayTeam id="6597" uniqueid="2203">FK AUSTRIA MAGNA</AwayTeam>
<TvChannels>
<TvChannel>PREMIERE Austria</TvChannel>
<TvChannel>PREMIERE SPORT PORTAL</TvChannel>
</TvChannels>/>
</MatchInfo>
</Match>
</BetradarLiveOdds> |
XML attributes definition | Element | Attributes |
|---|
| Attribute | Description | Possible values | | BetradarLiveOdds | status | What kind of information is contained in the message. | Long | Match
| active | Whether the match is still active or not. Set to 0 if the match is either removed, or if the client has unregistered for the match. In both cases a Message element can be added to the match. | Integer
0 = not active
1 = active | | matchid | The id of the match for which the matchinfo is sent. | Long | | status | The context status of the match, i.e. "not_started" | String
Examples:
not_started
in_progress
started
1set
... | | MatchInfo |
| The element containing all the match information | - | | DateOfMatch |
| The element contains the start time of the match | Unix timestamp | | Sport | - | The element contains a textual representation of the sport | String | | id | The id of the sport | Integer | | Category | - | The element contains the name of the category | String | | id | The id of the category | Integer | | Tournament | - | The element contains the name of the tournament | String | | id | The id of the tournament | Integer | HomeTeam
| - | The element contains the name of the home team | String | | id | The id of the home team in this tournament | Integer | | uniqueid | The id of the home team in all tournaments. Optional attribute, should only be used to identify that two teams in different tournaments are the same. | Integer | | AwayTeam | - |
| String | | id | The id of the away team in this tournament. | Integer | | uniqueid | The id of the away team in all tournaments. Optional attribute, should only be used to identify that two teams in different tournaments are the same. | Integer | | TvChannels | - | The element containing all the tv channels | - | | TvChannel | - | The element contains the name of the tv channel | String |
| Info |
|---|
Note
It is possible to include your own match id’s in the meta message. To do this you need to contact our support team, so they can set this up. When this is done, an extra attribute named sourceid will be included in the Match element for meta messages. The value of the attribute will be empty if we are missing your id for a particular match. |
In order to get streaming information in the meta information messages the correct XML configuration needs to be enabled. | Code Block |
|---|
| language | xml |
|---|
| title | XML example |
|---|
| <BetradarLiveOdds xmlns="http://www.betradar.com/BetradarLiveOdds" status="meta" timestamp="1405677142338">
<Match active="1" booked="1" matchid="4972075" status="not_started">
<MatchInfo>
<DateOfMatch>1405677600000</DateOfMatch>
<Sport id="1">Soccer</Sport>
<Category id="5">Norway</Category>
<Tournament id="5">Eliteserien</Tournament>
<HomeTeam id="5020" uniqueid="1161">ROSENBORG BK</HomeTeam>
<AwayTeam id="5293699" uniqueid="678">HØNEFOSS BK</AwayTeam>
<TvChannels/>
<Streaming>
<Channel id="1">Live Channel Retail LIVE Match</Channel>
<Channel id="2">Live Channel Retail LIVE Visualisation</Channel>
<Channel id="3">Live Channel Online LIVE Match</Channel>
<Channel id="4">Live Channel Online LIVE Visualisation</Channel>
</Streaming>
</MatchInfo>
</Match>
</BetradarLiveOdds> |
XML attributes definition | Element | Attribute |
|---|
| Attributes | Description | Possible values | | Streaming | - | The element containing all the streaming information | - | | Channel | - | The element contains the name of the streaming channel | String | | id | The id of the streaming channel | Long |
In order to get coverage information in the meta information messages the correct XML configuration needs to be enabled. | Code Block |
|---|
| language | xml |
|---|
| title | XML example |
|---|
| <BetradarLiveOdds xmlns="http://www.betradar.com/BetradarLiveOdds" status="meta" timestamp="1405677142338">
<Match active="1" booked="1" matchid="4972075" status="not_started">
<MatchInfo>
<DateOfMatch>1405677600000</DateOfMatch>
<Sport id="1">Soccer</Sport>
<Category id="5">Norway</Category>
<Tournament id="5">Eliteserien</Tournament>
<HomeTeam id="5020" uniqueid="1161">ROSENBORG BK</HomeTeam>
<AwayTeam id="5293699" uniqueid="678">HØNEFOSS BK</AwayTeam>
<TvChannels/>
<CoverageInfo>
<Type id="1">Extended markets</Type>
</CoverageInfo>
</MatchInfo>
</Match>
</BetradarLiveOdds> |
XML attributes definition | Element | Attributes |
|---|
| Attribute | Desctiption | Possible values | | CoverageInfo | - | The element containing all the coverage information | - | | Type | - | The element contains the name of the coverage info type | String | | id | The id of the coverage info type | Integer |
In order to get extra sport information in the meta information messages the correct XML configuration needs to be enabled. | Code Block |
|---|
<BetradarLiveOdds xmlns="http://www.betradar.com/BetradarLiveOdds" status="meta" timestamp="1405677142338">
<Match active="1" booked="1" matchid="4972075" status="not_started">
<MatchInfo>
<DateOfMatch>1405677600000</DateOfMatch>
<Sport id="1">Soccer</Sport>
<Category id="5">Norway</Category>
<Tournament id="5">Eliteserien</Tournament>
<HomeTeam id="5020" uniqueid="1161">ROSENBORG BK</HomeTeam>
<AwayTeam id="5293699" uniqueid="678">HØNEFOSS BK</AwayTeam>
<TvChannels/>
<ExtraInfo>
<Info type="PeriodLength">45</Info>
<Info type="OvertimeLength">15</Info>
</ExtraInfo>
<Streaming/>
</MatchInfo>
</Match>
</BetradarLiveOdds> |
XML attributes definition | Element | Attributes |
|---|
| Attribute | Description | Possible values | | Extrainfo | - | The element containing all the extra information for the sport. |
| | Info | - | The element contains the value of the extra information type. | String | | type | The id of the coverage info type | String |
For Tennis doubles matches, the meta information can hold info regarding the individual players within a team. Please note that tennis players are sent as team IDs. | Code Block |
|---|
| language | xml |
|---|
| title | XML example |
|---|
| <BetradarLiveOdds xmlns="http://www.betradar.com/BetradarLiveOdds" status="meta" timestamp="1489592713569">
<Match active="1" booked="1" matchid="11257013" status="not_started">
<MatchInfo>
<DateOfMatch>1489592925481</DateOfMatch>
<Sport id="5">Tennis</Sport>
<Category id="6">WTA</Category>
<Tournament id="57144">Indian Wells, USA, Doubles</Tournament>
<HomeTeam id="7057978" uniqueid="138370">HRADECKA L / SINIAKOVA K</HomeTeam>
<AwayTeam id="9547077" uniqueid="320177">ARRUABARRENA L / LIANG C</AwayTeam>
<HomeCompetitors>
<Team id="541426" uniqueid="19331">HRADECKA, LUCIE</Team>
<Team id="6226593" uniqueid="72376">SINIAKOVA, KATERINA</Team>
</HomeCompetitors>
<AwayCompetitors>
<Team id="5395461" uniqueid="46448">ARRUABARRENA-VECINO, LARA</Team>
<Team id="1122536" uniqueid="49884">LIANG, CHEN</Team>
</AwayCompetitors>
<TvChannels/>
</MatchInfo>
</Match>
</BetradarLiveOdds> |
XML attributes definition | Element | Attributes |
|---|
| Attribute | Description | Possible values | | HomeCompetitors | - | The element containing individual competitors (teams) for home team | - | | AwayCompetitors | - | The element containing individual competitors (teams) for away team | - | | Team | - | The element contains the name of the team | String | | id | The id of the team in this tournament | Integer | | uniqueid | The id of the team in all tournaments. Optional attribute, should only be used to identify that two teams in different tournaments are the same. | Integer |
|