Fixture end point

{"elements":{"metas":{"hidden":true},"spaces":{"hidden":true},"share":{"hidden":true},"people":{"hidden":true},"tools":{"hidden":true},"labels":{"hidden":true}},"cssSelector":"div.update-item-meta","cssSelectorLocked":false}AJS.trigger('hideelements.page.data.available')

The fixture end point provides a set of information related to a match/fixture.

In order to call the end point for a specific match, the id of the match must be inserted in the call as per following example:

api.betradar.com/v1/sports/en/sport_events/sr:match:19096428/fixture.xml

Main elements and sub elements provided by the Fixture end points are the ones shown in list below:

fixture
tournament_round
season
tournament
- sport
- category
competitors
- competitor
  - reference_ids
    reference_id
venue
tv_channels
- tv_channel
extra_info
- info
coverage_info
- coverage
product_info
- is_in_live_score
- is_in_hosted_statistics
- links
scheduled_start_time_changes
- scheduled_start_time_change

Fixture element (fixture)

Here follow some examples of the Fixture elements in the Fixture end point for different sports:

Table below shows the list and meaning of attributes in the Fixture element (in red in the first example above):

Attribute

Meaning

Possible values

Unique identifier of the event

Numeric string

Example:

id = "sr:match:19096428"

scheduled

When the specific match will start

Date

Example:

scheduled ="2019-10-23T00:00:00+00:00"

start_time_tbd

Specifies if the starting time is confirmed or not

True
False

status

Indicates whether this match is not started yet, live, or finished When it is ended, the results may not have been fully confirmed yet. When it is closed Betradar has confirmed the results.

Note: The event "match_about_to_start" in an indication that a given match/game will start shortly (within 5 minutes). This is sent manually by scouts. It does not trigger a betstop or has any special parameters per sport.

"not_started"
"live"
"ended"
"closed"
“cancelled"
“postponed”
“suspended”
“interrupted”
“delayed”
"match_about_to_start"

next_live_time

When live odds should be offered next time i.e. start of the match or when a match will start again after suspension.

Please note that this attribute is only sent when next_live_time is different from start_time.

At this point the customer will typically receive an Odds Change message with <sport_event_status reporting="1">

Date

Example:

scheduled ="2019-10-23T00:00:00+00:00"

liveodds

Indicates whether this match is booked by the customer for livecoverage.

“booked”
“bookable”
“buyable”
“not_available”

start_time

When the specific match will start.

Date

Example:

scheduled ="2019-10-23T00:00:00+00:00"

start_time_confirmed

If true, the start time is scheduled and confirmed (the event can still become delayed) otherwise, it could be a best guess.

True
False

Tournament_round element (tournament_round)

Information related to the tournament round element is available here: Tournament_round

Tournament element

Information related to the tournament element is available here: Tournament

Season Element (season)

Information related to the Season element is available here: Season

Competitors element

Information related to the competitors element is available here: Competitor

Venue element

TV channels

<tv_channels> <tv_channel name="Sky Sports Main Event - Astra 2A/2B/2D (28.2E)"/> <tv_channel name="Sky Sport Uno HD - Hot Bird 1/2/3/4/6 (13.0E)"/> <tv_channel name="Sky Sports Arena - Astra 2A/2B/2D (28.2E)"/> <tv_channel name="Sportkanalen HD - Sirius 2/3 (5.0E)"/> <tv_channel name="beIN Sports 1 HD France - Astra 1C-1H / 2C (19.2E)"/> <tv_channel name="CANAL+ SPORT HD PL - Hot Bird 1/2/3/4/6 (13.0E)"/> <tv_channel name="S SPORT HD - Eutelsat W3A (7.0E)"/> <tv_channel name="#Vamos ES - Astra 1C-1H / 2C (19.2E)"/> </tv_channels>

Extra_info element

Within this element, sport-specific key-value pairs are added to provide sport-specific details about the event.

<extra_info> <info key="neutral_ground" value="false"/> <info key="period_length" value="12"/> <info key="overtime_length" value="5"/> <info key="coverage_source" value="venue"/> <info key="extended_live_markets_offered" value="false"/>

</extra_info>

All the specific info are actually contained in the info element.

Info element

In the info element there 2 attributes which are "Key" and "Value".

The Key attribute specifies which kind of info is provided.

The "Value" attribute provides the actual value or info related to the "key" attribute.

Table below shows all the keys and the values which can be shown for each key.

Key

Meaning of key

Value

neutral_ground

Set to true if one of the competitors is playing on their home venue, otherwise set to false.

boolean

auto_traded

Set to true if the match is auto-traded. For auto-traded matches odds are solely generated by a mathematical odds model and live scoring. Any market monitoring and trader interaction is not considered.

boolean

draw_possible

Set if a draw is possible.

boolean

no_advantage_scoring

Only present and set to true if no advantage scoring is used. In this tennis rule mode, the first player to get 4 points wins the game.

boolean

best_of

The number of sets (or equivalent) that the match maximum will have. Typically the winner needs best_of/2 + 1 sets to win.

integer

set_limit

Number of points in a set (max).

integer

period_length

Number of minutes in a period

integer

overtime_length

Number of minutes for each overtime period.

integer

super_tie_break

Number of points required to win match deciding tiebreak.

integer

coverage_source

How are the live results obtained (directly from venue, from TV).

enumeration (venue, tv)

extended_live_markets_offered

What live markets will be offered; either the normal ones or an extended offering, depending on coverage type (basic or deeper coverage).

boolean

surface

Possible values: hard_court, grass, sand, red_clay, green_clay, hardcourt_outdoor, carpet_indoor, synthetic_indoor,

enumeration

best_of_legs

Number of legs. In darts a single game is called a leg. You win a match by winning a number of legs. In some competitions a

match consists of sets where each set consists of legs (in such cases both best_of and best_of_legs are typically available).

integer

Coverage info

For more detailed info related to Coverage info please, refer to page: Coverage_info

Product Info

Product info provides information on which other sportradar products are being active for the match.

In this case elements work differently from all the others as these do not have "true"/"false" values: they are just added if the product in question is available for the match.

Here follows an example:

<product_info>

<is_auto_traded/> <is_in_live_score/> <is_in_hosted_statistics/> <is_in_live_center_soccer/> <is_in_live_match_tracker/> <links> <link name="live_match_tracker" ref="https://widgets.sir.sportradar.com/sportradar/en/standalone/match.lmtPlus#matchId=27751122"/> </links>

<product_info/>

Element

meaning

<is_auto_traded/>

If present the match is autotraded

<is_in_live_score/>

If present, live score is available for the match

<is_in_hosted_statistics/>

If present, statistics are available for the match

<is_in_live_center_soccer/>

If present, live center soccer is available for the match

<is_in_live_match_tracker/>

If present, live match tracker is available for the match

In case of live match_tracker available for the match and hard-coded widget link is provided with the id of the match:

https://widgets.sir.sportradar.com/sportradar/en/standalone/match.lmtPlus#matchId="matchid"

The link redirects to the match tracker for the match

scheduled_start_time_changes

- scheduled_start_time_change

PreviousTournament we provide coverage for NextAll seasons

Was this helpful?