# \[Deprecated] Probabilities and cashout The probability endpoints can be found near the bottom of our self-service documentation. * For the production environment: * For the integration environment: **Currently, the cashout service is available for matches that fit the following criteria**: The match is for a cashout supported sport:\ \&#xNAN;*Soccer, Baseball, Basketball, Tennis, Table Tennis, Badminton, Volleyball, Beach Volleyball, Squash, Handball, Ice Hockey, Field Hockey* **Table of contents** **XML contentCashout statusError messagesInclude partly refundable probabilities** * 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 5 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. 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 cash out 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 cash out 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 ```xml …Probability lower than 1e-10… ``` **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). **Probability API**
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. | Endpoint | Path Parameters | Description | | ------------------------------------------------------- | -------------------------------------- | ---------------------------------------------------------------------------------------------- | | /probabilities/sr:match:{matchid} | Match id | Retrieve all probabilities available for the specified match. | | /probabilities/sr:match:{matchid}/{market}/{specifiers} | Match id, market id, market specifiers | Retrieve the probabilites for the specified market line. | | /probabilities/sr:match:{matchid}/{market} | Match id, market id, market specifiers | Retrieve all the probabilities for all the market lines for the specified match and market id. | **XML content** The following table has an overview over what elements are present in the Cashout XML response. | Element | Description | Attribute | Description | Possible values | | -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | cashout | Top level element | product | What product the probabilities come from | Currently only 1 for Live Odds | | event\_id | Match id | The match id in urn format, sr:match:{matchid} | | | | timestamp | When the message was created | The number of milliseconds since January 1, 1970 UTC | | | | sport\_event\_status | Subelement of cashout. Has attributes for the sport event's current status. See more in the dedicated section for more information about this sub element. | status | The current betstatus | | | match\_status | The current match status |

Soccer

| | | | odds | Subelement of cashout. This element contains all the active markets. The odds element with market probabilities are available also when the match is on betstop. |


|


|


| |


|


|


| | | |


|


|


| | | |


|


|


| | | | market | Subelement of odds. Contains market information. The markets are only added to the odds element if the match is on betstart. | id | Unified feed market id | Integer | | specifiers | Unified feed market specifiers | String | | | | status | Market status | | | | | cashout\_status | The cashout status of the market | | | | | outcome |


| id | Unified feed outcome id | Integer | | probabilities | Outcome probability | Raw model output. Not rounded. | | | | active | If the outcome is active | | | | **Cashout status** Each market element will have a cashout\_status attribute determining if the market is available for cashout or not. The value of the cashout\_status attribute will be determined by the following rules, applied in prioritized order: | **Id** | **Name** | **Description** | | ------ | ----------- | ----------------------------------------------------------------------------------------------------------------------------- | | **-2** | Closed | Market is settled or canceled. | | **1** | Available | Market is active and match is on betstart or early betstart if the bookmaker has early betstarts enabled in his configuration | | **-1** | Unavailable | Default status. A market will be unavailable in cashout unless any of the rules above apply. | A market will only contain cashout probabilities if the cashout status is Available (cashout\_status=”1”). XML example ```xml ``` **Error messages** This section covers what error messages the server will reply with if something went wrong or some of the provided information is incorrect, etc. | **Symptom** | **Reason** | | ---------------------------------------- | ------------------------------------------------- | | XML Message with response code Forbidden | No authentication token | | XML Message with response code Forbidden | Invalid authentication token | | 500 Internal server error | Error processing the request | | 404 Not Found | Trying to access resource that does not exist | | 403 Forbidden | Bookmaker is blocked from accessing that resource | **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 and is currently only applied for the sport soccer. Click the links in the box below to download additional information: | | File | Modified | | - | ---------------------------------------------------------------------------------------- | -------------------------- | | | PDF File Cashout\_Function\_201119 .pdf | 26/May/20 by Stefan Pammer | | |

Labels

$itemLabel $itemLabel

| | | | Microsoft Excel Spreadsheet Cashout Algorithm\_051218.xlsx | 26/May/20 by Stefan Pammer | | |

Labels

$itemLabel $itemLabel

| | * Drag and drop to upload or browse for files Upload file File description Download All --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.sportradar.com/uof/support-and-history/archived/deprecated-probabilities-and-cashout.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.