Probabilities API & Cashout

Probability API Endpoints

In order to offer cashout probabilities, we provide a cashout API where the clients can request the cashout probabilities for all markets for all active matches.

HTTP

End point path

GET

Name:  UOF - Sport Event Probabilities

Path: /probabilities/{urn_type}:{id}
Description: Get probabilities for a sport event

GET

Name: UOF - Market Probabilities 

Path: /probabilities/{urn_type}:{id}/{market-id}
Description: Get probabilities for a sport event's specific market

GET

Name: UOF - Market Probabilities with Specifiers

Path:/probabilities/{urn_type}:{id}/{market-id}/{specifiers}
Description: Retrieve the probabilities for the specified market line.

Eligibility for Cashout Option

Currently, the cashout service is available for matches that fit the following criteria:

The match is for a cashout-supported sport: Soccer, Baseball, Basketball, Tennis, Table Tennis, Badminton, Volleyball, Beach Volleyball, Squash, Handball, Ice Hockey, Field Hockey

The match is active in Live Odds (and you have Live Odds access to this match): Live Odds is offered for this match; odds are enabled 15 minutes before match start
The match is not older than 6 days
Test clients/accounts do not have access to the probability/cashout API

Matches that do not fit the above criteria will not be available in the cashout service.

Why do we provide probabilities?

The purpose of the probabilities is to give Betradar clients a way to offer their customers the option to cash out on bets that have already been placed, but are not settled yet. This is done in order to increase turnover. To cashout a bet, the client needs to know the current probability of the outcomes, so that they can offer a reasonable return for a customer that wants to cashout a bet before the bet can be definitively settled. To do this, our probabilities service offers probabilities for all active markets and all markets that have previously been offered for the match.

Currently we offer probabilities down to 1e-10 (0.0000000001), and markets with a lower probability than this will be ignored. The feed will produce a message that has a valid odds value, but the probability value will be missing from this market outcome.

XML example

<market favorite="1" status="1" id="435" specifier="framenr=4"> <outcome id="1" odds="1.7" probabilities="0.54865 active="1"/> <outcome id="2" odds="3.8" probabilities="0.22432 active="1"/> <outcome id="3" odds="20.0" active="1"/> …Probability lower than 1e-10…</market>

Note: The normal odds_change message include probabilities for the markets offered in the odds_change message. Customers are strongly recommended to cache and use probabilities where available for speed and efficiency reasons. The probabilities API is primarily intended for market lines with low likelihood that are currently not offered in the odds_change message (e.g. a totals line with a total far from the current most likely total).

Custom Configuration

Include partly refundable probabilities

If you enable this configuration it will allow the possibility to include the probabilities of asian handicap markets (i.e. markets with x.0, x.25 and x.75 lines), both for asian handicap, asian total and no bet markets (draw no bet, home no bet, etc.).

Asian outcomes refer to the probabilities for:

win probabilities
lose probabilities
refund probabilities
half win probabilities
half lose probabilities

XML Example

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<cashout product="1" event_id="sr:match:20005429" timestamp="1571216072115">
    <sport_event_status status="0" match_status="0"/>
    <odds>
        <market status="-1" cashout_status="-1" id="16" specifiers="hcp=-1.25">
            <outcome id="1715" probabilities="0.5553225068056259" win_probabilities="0.3862513744416066" lose_probabilities="0.39633879985491377" half_win_probabilities="0.21740974186924522" half_lose_probabilities="0.0" active="1"/>
            <outcome id="1714" probabilities="0.4446774931943741" win_probabilities="0.39633879985491377" lose_probabilities="0.3862513744416066" half_win_probabilities="0.0" half_lose_probabilities="0.21740974186924522" active="1"/>
        </market>
        <market status="-1" cashout_status="-1" id="16" specifiers="hcp=-1">
            <outcome id="1715" probabilities="0.4935550505882632" win_probabilities="0.3862513744416066" lose_probabilities="0.39633879985491377" refund_probabilities="0.21740974186924522" active="1"/>
            <outcome id="1714" probabilities="0.5064449494117368" win_probabilities="0.39633879985491377" lose_probabilities="0.3862513744416066" refund_probabilities="0.21740974186924522" active="1"/>
        </market>
        <market status="-1" cashout_status="-1" id="11">
            <outcome id="4" probabilities="0.8575649164628653" win_probabilities="0.6137485417241589" lose_probabilities="0.10193901724880175" refund_probabilities="0.2843123571928049" active="1"/>
            <outcome id="5" probabilities="0.14243508353713483" win_probabilities="0.10193901724880175" lose_probabilities="0.6137485417241589" refund_probabilities="0.2843123571928049" active="1"/>
        </market>
        <market status="-1" cashout_status="-1" id="16" specifiers="hcp=-0.75">
            <outcome id="1715" probabilities="0.4333596828321439" win_probabilities="0.3862513744416066" lose_probabilities="0.39633879985491377" half_win_probabilities="0.0" half_lose_probabilities="0.21740974186924522" active="1"/>
            <outcome id="1714" probabilities="0.5666403171678561" win_probabilities="0.39633879985491377" lose_probabilities="0.3862513744416066" half_win_probabilities="0.21740974186924522" half_lose_probabilities="0.0" active="1"/>
        </market>
        <market status="0" cashout_status="-1" id="1"/>
    </odds>
</cashout>

Note: The configuration "Enable market refund probabilities" is accessible via https://config.betradar.com/feed-options and is currently only applied for the sport soccer.