> For the complete documentation index, see [llms.txt](https://docs.sportradar.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sportradar.com/uof/custombet-cb/intro.md).

# Intro

Custom Bet is a service that **enables you to build your own** **Bet Builder feature**, giving punters the freedom to create **highly personalized betting experiences**. By combining multiple selections—whether within a single match or across different matches—you can offer engaging, flexible betting options that drive both **margin growth** and **player satisfaction**.

Check our [product sheet ](https://resources.sportradar.com/custom-bet/custom-bet-sheet)to understand Custom Bet on one page.

**Key Benefits / Use Cases**

* You can customize your odds pricing for the Bet Builder by choosing a specific odds key or using any odds source to define the margin.
* You can enhance your punters' engagement by using our AI-driven pre-built recommendations, or our highly customizable combination options.
* You can choose the best integration solution for your business:
  * **API solution** (supports [SDK](https://docs.betradar.com/display/BD/UOF+-+SDK)) to design your own front end and tailor the experience fully.
  * **Front-end widget solution** for faster integration into your existing platform. - *Reach out to our sales or support team for more information.*

#### **2. Supported Sports & Markets** <a href="#id-wip-custombetapidocumentationredesign-2.supportedsports-and-markets" id="id-wip-custombetapidocumentationredesign-2.supportedsports-and-markets"></a>

Custom Bet uses a limited number of selected markets provided in our *Unified odds feed* product for each supported sport.

Check out the [Custom Bet Market List page](https://docs.sportradar.com/uof/introduction/market-overview-uof-and-cb) for the detailed list of markets we support.&#x20;

{% hint style="info" %}
**Note:**

* For all Total and Handicap lines, we only support x.5 market lines.
* All Asian outcomes are not supported in Custom Bet, as we do not currently provide calculations for partly-voided outcomes.

**Soccer Pre-match Player markets Coverage Updates:**&#x20;

* Custom Bet currently supports up to 28 players per match for Soccer Pre-match Player markets (14 per team). As a result, not all players from the 3rd party UOF feed are available. Players are selected based on overall market coverage, prioritising those appearing across the widest range of supported player markets to maximise line availability. For example, players present in Shots, Assists, Goals, and Passes markets are prioritised over those in fewer markets. Where coverage is equal, scoring probability is also considered.&#x20;
* Recommended practice: please use the /available-selection endpoint to retrieve the full list of supported players and markets. &#x20;
* We are also working towards expanding coverage to include all UOF feed players in a future release.&#x20;
  {% endhint %}

| Sport             | Pre-match               | Live                     | Tournament                                                                                      |
| ----------------- | ----------------------- | ------------------------ | ----------------------------------------------------------------------------------------------- |
| Soccer            | ✅                       | ✅                        | Custom Bet supports all tournaments for which the specific market is supported in the UOF feed. |
| Basketball        | ✅                       | ✅                        | Custom Bet supports all tournaments for which the specific market is supported in the UOF feed. |
| Tennis            | ✅                       | ✅                        | Custom Bet supports all tournaments for which the specific market is supported in the UOF feed. |
| Ice Hockey        | ✅                       | ✅                        | Custom Bet supports all tournaments for which the specific market is supported in the UOF feed. |
| American Football | ✅                       | Coming soon in Q3’26     | Custom Bet supports NFL now. Other tournaments coming soon.                                     |
| Baseball          | ✅                       | Coming soon in June 2026 | Custom Bet supports all tournaments for which the specific market is supported in the UOF feed. |
| Cricket           | ✅                       | Coming soon in July 2026 | Custom Bet supports all men T20 tournaments. Other tournaments coming soon.                     |
| Volleyball        | ✅                       | Coming soon              | Custom Bet supports all tournaments for which the specific market is supported in the UOF feed. |
| MMA               | Coming soon in May 2026 |                          | Custom Bet supports all tournaments for which the specific market is supported in the UOF feed. |

#### **3. Our Solutions** <a href="#id-wip-custombetapidocumentationredesign-3.oursolutions" id="id-wip-custombetapidocumentationredesign-3.oursolutions"></a>

These are the 2 solution you can choose to build your own Bet Builder feature.

<table data-full-width="false"><thead><tr><th>Solution</th><th>When to choose it?</th></tr></thead><tbody><tr><td>API</td><td><ul><li>Use this if you want a fully customized front-end experience.</li><li>Provides maximum flexibility to design your own interface and user experience.</li><li>Supports <a href="https://docs.betradar.com/display/BD/UOF+-+SDK">SDK</a></li></ul></td></tr><tr><td>Front-end</td><td><ul><li>Use this if you want fast, easy integration. </li><li>The widget can be iframed into your website for quick deployment. Ideal if you have limited time or resources and want to test the feature quickly. You can opt for our API solution afterwards when you finish building your own front end.</li><li>Demo: <a href="https://widgets.sir.sportradar.com/custom-bet#matches:(matchId:50852263,sportId:1)">https://widgets.sir.sportradar.com/custom-bet#matches:(matchId:50852263,sportId:1)</a></li><li>Reach out to our sales or support team for more information.</li></ul></td></tr></tbody></table>

**API solution**

These are the 4 main API endpoints you can use to build your Bet Builder. Check each page for the detailed guide to each API endpoint.

* [**Available Selection**](/uof/custombet-cb/api/available-selections.md): Gives you all available markets that can be combined with the Custom Bet.
* [**Calculate**](/uof/custombet-cb/api/calculate.md)**:** Returns the odds and probability of the selected combination. Also provides remaining available selections.
* [**Calculate Filter**](/uof/custombet-cb/api/calculate-filter.md)**:** Returns the same information as Calculate (odds and probabilities). Additionally, flags selections that conflict with the current combo.
* [**Pre-Built**](/uof/custombet-cb/api/pre-built-bet-recommendation.md)**:** Provides AI-powered personalized recommended pre-built combos with odds pricing.

**Other Features we support**

* **Source-Agnostic solution:** you can **use any odds sources** you want, and we will harmonize your single odds with the Custom Bet odds to generate the most competitive pricing. [Check here for the guide](/uof/custombet-cb/source-agnostic-solution-harmonization-feature.md).
* **Multi-match request:** **combine up to 5 matches** with a maximum of 10 selections per match. [Check here for the guide](/uof/custombet-cb/api/calculate.md).
* **Multi-sport request:** Multi-sport request: combine up to 5 matches across multiple sports with a maximum of 10 selections per match. [Check here for the guide](https://docs.sportradar.com/uof/custombet-cb/api/calculate). All sports are supported except Tennis, which is coming in Q3.
* **Combination flexibility:** You can freely combine any markets as long as they do not conflict. Even if two selections imply the same outcome, we still allow the combination—helping you increase bet volume and reduce ticket rejection rates.

| Sports            | Source-Agnostic                                                                    | Multi-match & Multi-sport                                                          |
| ----------------- | ---------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
| Soccer            | ✅                                                                                  | ✅                                                                                  |
| Basketball        | ✅                                                                                  | ✅                                                                                  |
| Tennis            | <p>Live - Coming soon in June 2026 </p><p>Pre-match - Coming soon in Aug 2026 </p> | <p>Live - Coming soon in June 2026 </p><p>Pre-match - Coming soon in Aug 2026 </p> |
| Ice Hockey        | ✅                                                                                  | ✅                                                                                  |
| American Football | ✅                                                                                  | ✅                                                                                  |
| Baseball          | ✅                                                                                  | ✅                                                                                  |
| Cricket           | ✅                                                                                  | ✅                                                                                  |
| Volleyball        | ✅                                                                                  | ✅                                                                                  |
| MMA               | Coming soon in May 2026                                                            | Coming soon in May 2026                                                            |

#### **4.** Combination Rules <a href="#id-wip-custombetapidocumentationredesign-4.combinationrules" id="id-wip-custombetapidocumentationredesign-4.combinationrules"></a>

* Max 10 selections per match and Max 5 matches in one request. Matches can belong to the same sport or different sports.&#x20;
* All combinations are allowed as long as they do not conflict, meaning thst the selections cannot happen at the same time. &#x20;
* If you are not using [harmonization](https://docs.sportradar.com/uof/custombet-cb/source-agnostic-solution-harmonization-feature) (not sending us your single odds), then you will not be able to combine selections that imply same result. You will receive an error message “One or more market selections imply a similar outcome to another market selection.”&#x20;

#### **5. Environments** <a href="#id-wip-custombetapidocumentationredesign-5.environments" id="id-wip-custombetapidocumentationredesign-5.environments"></a>

<table data-full-width="false"><thead><tr><th>Environments</th><th>Guideline</th></tr></thead><tbody><tr><td>Integration</td><td><p>Use this environment for <strong>testing and development</strong> before release.</p><p><em>Note:</em> Since it is also used for ongoing development, testing, and deployments, results may differ from production. Performance and reliability are not guaranteed.</p></td></tr><tr><td>Production</td><td><p>Use this environment for <strong>real user traffic and live experiences</strong>.</p><p><em>Note:</em> Do not use for testing to ensure production requests are processed reliably.</p></td></tr></tbody></table>

For more information about API availability, access restrictions and functionality related to these, please see the [Unified Odds feed integration documentation.](https://docs.betradar.com/pages/viewpage.action?pageId=2162692)&#x20;

#### **6. API Access & Data Availability** <a href="#id-wip-custombetapidocumentationredesign-6.apiaccess-and-dataavailability" id="id-wip-custombetapidocumentationredesign-6.apiaccess-and-dataavailability"></a>

**Products Access**

Custom Bet is offered per Sport + Pre-match/Live combination. For example, to access both Soccer Live and Soccer Pre-match, you must activate two separate products: *Soccer Live Custom Bet* and *Soccer Pre-match Custom Bet*.

**Rate Limit**

<table data-full-width="false"><thead><tr><th>Environment</th><th>Default Limit</th><th>Pro Package</th><th>Premium Package</th></tr></thead><tbody><tr><td>Production</td><td>100 req/sec</td><td>250 req/sec</td><td>500 req/sec</td></tr><tr><td>Integration</td><td>100 req/sec</td><td>250 req/sec</td><td>500 req/sec</td></tr></tbody></table>

⚠️ For higher limits, please contact your commercial representative to upgrade the product.

**Data Availability**

<table data-full-width="false"><thead><tr><th>Event Type</th><th>Availablity</th></tr></thead><tbody><tr><td>Pre-match</td><td>Pre-match Custom Bet is available once you receive <em>side markets</em> (markets other than 2-way, 3-way, or totals) from UOF, until handover to Live.</td></tr><tr><td>Live</td><td><p>Live Custom Bet is available after handover from Pre-match to Live odds, until the match ends.</p><p>And you need to book the Live event on our Live Booking Calendar.</p></td></tr><tr><td>Completed matches</td><td>Not supported</td></tr></tbody></table>

⚠️ Betpal (Producer 4) is supported on Custom Bet. However, it is strongly recommended to enable the Harmonization feature. Without Harmonization, customers are advised that Custom Bet will use underlying probabilities to form Custom Bet odds and not ALPHA odds probabilities. We recommend all customers to use Harmonization to have the most optimum Custom Bet Odds available.

#### **7. Odds & Margins** <a href="#id-wip-custombetapidocumentationredesign-7.odds-and-margins" id="id-wip-custombetapidocumentationredesign-7.odds-and-margins"></a>

**How Odds Are Calculated:**

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

1. Calculate correlation: We use simulation data to assess the correlation between all selections. There are three types:
   * Independent: One selection does not affect another.
   * Positively correlated: One selection makes another more likely.
   * Negatively correlated: One selection makes another less likely.
2. Calculate combined probabilities: Multiply the individual fair probabilities of each selection and adjust by the correlation factor to get the combined probability. For example: Combined Probability = Correlation factor \* Probability 1\*Probability 2\*Probability 3\*...&#x20;
3. Convert probability to odds: The combined fair probability is then converted into fair odds = 1/fair probability
4. Apply margin: Finally, a margin is added on top of the fair odds to generate the final odds offered. (See below for 2 margin options).

**Margin / Odds Key Configuration**

We offer two types of margin and odds key options, but only one can be applied at a time.

<table data-full-width="false"><thead><tr><th>Options</th><th>What is it?</th><th>How to use it?</th></tr></thead><tbody><tr><td><p>Harmonization</p><p>(Recommended)</p></td><td><p>We use your single odds price to calculate the Custom Bet odds. This will ensure Custom Bet odds are aligned with your single odds and provides consistent, competitive pricing.</p><p>This approach is <strong>source-agnostic</strong>, so you can use any odds sources you want. <a href="/pages/ZOAxeMCAuSnchkUgIT1x">Explanation of source-agnostic solution</a>.</p><p>For example you want to combine market A and market B, we will use our model to calculate the correlation factor (see the explanation), and multiply it with all your single odds of each selection.</p><p>Calculation formula = Single odds (Market A) * Single odds (Market B) * Correlation factor.</p></td><td><p>Simply send us the odds of each single selection in the request.</p><p>&#x3C;selection id="sr:match:14736961" market_id="14" specifiers="hcp=1:0" outcome_id="1711" odds="2.4"/> &#x3C;selection id="sr:match:14736961" market_id="26" outcome_id="70" odds="3.5"/></p><p><br></p><p>You can set a <strong>max cap</strong> on your harmonized odds, so that you can ensure it is within your risk management. Please reach out to the support team and we can set this up for you.</p></td></tr><tr><td><p>Odds Key Ladder</p><p><img src="https://confluence.sportradar.ag/plugins/servlet/twitterEmojiRedirector?id=26a0" alt="warning"> To be deprecated, so please do not use this if you are starting to integrate</p></td><td><p>Select among four odds key options, and this will be applied on top of the fair Custom Bet odds.</p><p>The odds key will be used for all Custom Bet odds, and we do not consider your single odds and probabilities adjusted for specific selections via CTRL (pre-match) or Betpal (live).</p></td><td><p>The Custom Bet ladder will be configurable through <a href="https://docs.betradar.com/pages/viewpage.action?pageId=2163703">Betradar Ctrl</a> (feed options > Custom Bet tab)<br><br></p><p>Please find the mapping of fair odds to Custom Bet odds for each ladder in the chart below.</p><p><br></p></td></tr></tbody></table>

\
**Odds Key Ladder Mapping**

| fair odds | Aggressive (105) | Moderate (110) | moderate (flat) | Conservative (115) |
| --------- | ---------------- | -------------- | --------------- | ------------------ |
| 1         | 1                | 1              | 1               | 1                  |
| 1,001     | 1,0005           | 1              | 1               | 1                  |
| 1,02      | 1,015            | 1,01           | 1,01            | 1,005              |
| 1,05      | 1,04             | 1,03           | 1,03            | 1,02               |
| 1,1       | 1,08             | 1,07           | 1,07            | 1,05               |
| 1,2       | 1,17             | 1,15           | 1,16            | 1,12               |
| 1,4       | 1,36             | 1,32           | 1,33            | 1,28               |
| 1,7       | 1,63             | 1,57           | 1,6             | 1,51               |
| 2         | 1,9              | 1,82           | 1,85            | 1,74               |
| 2,5       | 2,36             | 2,23           | 2,25            | 2,11               |
| 3,5       | 3,25             | 3              | 3               | 2,8                |
| 5         | 4,5              | 4,1            | 3,8             | 3,8                |
| 10        | 8,5              | 7,5            | 6               | 7                  |
| 20        | 16               | 14             | 9               | 12                 |
| 50        | 40               | 33             | 18              | 25                 |
| 100       | 70               | 50             | 22              | 30                 |
| 1000      | 300              | 200            | 50              | 100                |
| 10000     | 750              | 500            | 70              | 250                |
| 100000    | 2000             | 1000           | 80              | 500                |

***

#### **8. Best Practices** <a href="#id-wip-custombetapidocumentationredesign-8.bestpractices" id="id-wip-custombetapidocumentationredesign-8.bestpractices"></a>

* **Punter Placing a Bet**

  * Use **Available Selection endpoint** to show users all possible markets.
  * When a user selects a combo, call **Calculate Filter endpoint** to get odds and disable conflicting selections.
  * Before placing a bet, call **Calculate endpoint** for a fast, accurate odds response.

  **Offering Pre-Built Recommendation**

  * Get recommended pre-built combos and display it on the event page or homepage for quick bet placement.
  * For Pre-match Pre-Built recommendations, we recommend caching the odds price for 15 seconds, since Pre-match prices rarely change quickly, which reduces excessive API calls.
  * If you need to update the odds for a specific pre-built, call **Calculate endpoint** endpoint for a fast response without the need for filtering.

  **Handling Settlements & Voided Markets:**

  * Store the final accepted custom bet ticket
  * Listen to the feed for settlements of individual markets.
    * Won: all selections are won&#x20;
    * Void: at least one selection is void and all other selections are won&#x20;
    * Lost: at least one selection is lost&#x20;
  * The settlement logic should follow the same principles as handling combination bets across different events.

<br>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.sportradar.com/uof/custombet-cb/intro.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.