# Custom Outrights

Sportradar has recently introduced Custom Content Creation for Outrights via CTRL in Betradar Portal. This feature allows you to create your Custom Content for SR Outrights and control the full cycle from custom creation through to settlements. This document outlines the creation process and explains how to settle Outrights been created by the user.

### Monitor Outrights 

Once you log into the Betradar Portal, CTRL can be accessed via the dropdown on the right-hand side. Navigate to the Monitor Outrights tab to display both **Active** and **Full trees** for the full Betradar sports offering. 

From the Active sports tree, select the sport, category, and tournament for which you want to create a custom outright. 

<figure><img src="/files/AnqHiZS9LN1dYwpRb4wy" alt=""><figcaption></figcaption></figure>

### Creating a Custom Outright&#x20;

{% hint style="info" %}
Complete steps to create a custom Outright.
{% endhint %}

{% @storylane/embed subdomain="app" linkValue="jkzq2vwtny6i" url="<https://app.storylane.io/share/jkzq2vwtny6i>" %}

When you have found the tournament you want to add a custom outright to (**following the steps: Sports>Category>Tournament**), you will have two options to create the new custom outright.&#x20;

The first option is the icon on the left-hand side near the top of the page, located under the Active tree and Full trees at the Tournament level. The second option is on the right-hand side. where the user will see ‘Add New Outright’.&#x20;

<figure><img src="/files/GaD7R21D0qDzzwkh0eZz" alt=""><figcaption></figcaption></figure>

When you click on the ‘Add New Outright’, a pop-up will appear. You can then name the Outright they wish to create and enter the start date, end date, and next bet stop date. The Bet stop date allows you to automatically suspend the outright when necessary, such as matchdays or any circumstance that would impact the market.&#x20;

Once you have provided a name and adjusted the relevant dates, they can choose the type of Outright they require from the following options: Championship Outright, Short Term Outright, Top 3 Outright, Top X Outright.

<figure><img src="/files/5ikYIif7zszKGo91nxv2" alt=""><figcaption></figcaption></figure>

### Configuring the Outright &#x20;

Once a Custom Outright has been created, you can add Outcomes by entering the desired number of selections required, then manually adding the Outcome names.&#x20;

After all Outcomes have been created and named, you can enter odds values in decimal format, with the minimum allowed value being 1.001. The Odds Key value must be over 100% for Championship Outright and Short Term Outrights, over 300% for Top 3 Outrights and over the value of ‘x’ for Top X Outrights (e.g., Top 4 Outrights must have an odds key value of 400% or greater).&#x20;

Once you are satisfied with the Outcomes and odds values entered, the Outright can be published, making it live and open for betting.&#x20;

<figure><img src="/files/4CmHF1UWWcNgBqLLWR47" alt=""><figcaption></figcaption></figure>

#### Suspending the Outright &#x20;

You can suspend the Outright at any time using the SUSPEND button at either the Outright level or the Competition level.&#x20;

<figure><img src="/files/kNNku4hR0FLENLCNW7zr" alt=""><figcaption></figcaption></figure>

Once suspended, the Outright will be closed for betting. The Outright can be reopened by using the PUBLISH button.

<figure><img src="/files/7Ri8UgiqR4vR8NNhTdcJ" alt=""><figcaption></figcaption></figure>

#### Adjusting the odds and Odds Key value &#x20;

Once a Custom Outright is created and offered, the odds and Odds Key value can be adjusted to provide the desired odds. This can be done by clicking the icon next to the Odds Key value.&#x20;

<figure><img src="/files/zk6Dgr7Yg4ghSbfmn2Od" alt=""><figcaption></figcaption></figure>

Manually adjusting the odds will automatically update the odds key value without any need to adjust the configuration. Once the odds have been adjusted the SAVE button needs to be clicked to save the changes.&#x20;

&#x20;

### Outright History &#x20;

Once the Outright is offered, you can view all relevant changes within the HISTORY tab, which includes odds changes, bet stop history and settlement history.&#x20;

You can filter by Odds Change, Settlements or Cancellations. Colours are used for Odds Changes to indicate in which direction the odds have changed. If the odds value has increased, the outcome will appear in RED, whereas if the odds value has decreased, the outcome will appear in BLUE.&#x20;

<figure><img src="/files/obFP8LjZFSrwZ2hIA6Eq" alt=""><figcaption></figcaption></figure>

### Settlements &#x20;

Custom Outrights need to be manually settled as these cannot be settled by Betradar. You can settle or void outcomes as well as using a void factor to partially void if desired. You can re-settle outcomes in case of any errors. The ‘Edit Settlements’ button can be used to manually settle or void the outright. Once clicked, the ‘Set as WINNER’ radio button can be used to select a winning outcome, or the ‘Void all Outcomes’ can be used if the outright needs to be voided, with several different void outcomes available.&#x20;

<figure><img src="/files/6GiKstQ0bunbhYIACvGH" alt=""><figcaption></figcaption></figure>

Once the desired settlements have been applied. the ‘Save Settlements’ button can be used to save these changes. The Settlement history can be seen in the HISTORY tab.

<figure><img src="/files/9ATbFUnUgnaPKZ1bK22B" alt=""><figcaption></figcaption></figure>

### Technical Documentation &#x20;

Outrights are ordinary markets in the Unified Odds Feed. Hence, odds updates are provided with ordinary odds\_change messages and resulting is provided with normal bet\_settlement messages. This is no different with Custom Outrights. &#x20;

Currently, we only support custom free-text custom outrights. Free text markets can be identified using the market description endpoint (see/descriptions/{language}/markets.xml endpoint on <https://iodocs.betradar.com/>) by inspecting the includes\_outcomes\_of\_type XML attribute, which is set to “pre\_outcometext”. Please note, this attribute only identifies free-text markets and cannot be used to distinguish between SR and custom free-text markets. &#x20;

Custom outrights can be distinguished from SR outrights, by reviwing the content of the UOF messages: &#x20;

* Custom outrights will have the “variant” specifier prefixed with value “ccc:markettext” (instead of “pre:markettext” for SR outrights) &#x20;
* Outcomes on custom outrights will have identifiers prefixed with value “ccc:outcometext” (instead of “pre:outcometext” for SR outrights) \
  &#x20;

Example:&#x20;

```xml
<odds_change product="3" event_id="sr:season:98413" timestamp="1666615165554"> 

   <odds> 
      <market favourite="1" status="1" id="534" specifiers="variant=ccc:markettext:369"> 
         <market_metadata next_betstop="1679572800000" start_time="1678831200000" end_time="1695682799000"/> 
         <outcome id="ccc:outcometext:1411" odds="4.0" probabilities="0.23926596236044909" active="1"/> 
         <outcome id="ccc:outcometext:1412" odds="2.2" probabilities="0.4401835094098877" active="1"/> 
         <outcome id="ccc:outcometext:1413" odds="3.0" probabilities="0.3205505282296633" active="1"/> 
   </market 

Like Betradar created Outright markets, ‘multiwinner’ Custom Outright markets such as Top 3 or Top X will include the “winners” specifier. Example: 

<odds_change product="3" event_id="sr:season:93963" timestamp="1666617466790" request_id="63223"> 
   <odds> 
      <market favourite="1" status="1" id="536" specifiers="variant=ccc:markettext:370|winners=2"> 
         <market_metadata next_betstop="1669809600000" start_time="1659736800000" end_time="1685833199000"/> 
         <outcome id="ccc:outcometext:1414" odds="2.0" probabilities="0.49000377161558634" active="1"/> 
         <outcome id="ccc:outcometext:1415" odds="2.5" probabilities="0.39044183897517853" active="1"/> 
         <outcome id="ccc:outcometext:1416" odds="3.2" probabilities="0.3039734164892289" active="1"/> 
         <outcome id="ccc:outcometext:1417" odds="4.5" probabilities="0.2153871659382711" active="1"/> 
         <outcome id="ccc:outcometext:1418" odds="7.0" probabilities="0.1380299646747654" active="1"/> 
         <outcome id="ccc:outcometext:1419" odds="8.0" probabilities="0.12069125685264513" active="1"/> 
         <outcome id="ccc:outcometext:1420" odds="8.5" probabilities="0.11355887730437818" active="1"/> 
         <outcome id="ccc:outcometext:1421" odds="8.0" probabilities="0.12069125685264513" active="1"/> 
         <outcome id="ccc:outcometext:1422" odds="9.0" probabilities="0.1072224512973011" active="1"/> 
      </market> 
```

### API info &#x20;

Using <https://iodocs.betradar.com/>, information about Custom Outrights can be requested in two endpoints: &#x20;

* /descriptions/(language)/markets/(market\_id)/variants/variant\_urn) &#x20;
* /(product)/descriptions/(language)/markets/(market\_id/variants/(variant\_urn)&#x20;

&#x20;

```xml
<?xml version='1.0' encoding='UTF-8'?>
<market_descriptions response_code="OK">
  <market id="534" name="AFL - winning region" variant="ccc:markettext:369">
    <outcomes>
      <outcome id="ccc:outcometext:1411" name="Sydney"/>
      <outcome id="ccc:outcometext:1412" name="Melbourne"/>
      <outcome id="ccc:outcometext:1413" name="Brisbane"/>
    </outcomes>
  </market>
</market_descriptions>
``
```


---

# 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/ctrl/guide/custom-outrights.md?ask=<question>
```

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.