# Number Betting Service

Numbers betting delivers betting markets on various lotteries. The events in Numbers Betting represent a single draw of a lottery and uses event\_ids like wns:draw:1234. The draws are connected to one lottery, similar to how matches are connected to a tournament. Numbers betting still uses the same concept of categories and a sport, 108. Most attributes about a draw are shared between all draws in a lottery. Only draw time, results and the match status is specific to a draw.

In order to start receiving Numbers Betting messages, you need to select what lottery types you want to receive from the ctrl feed options page.

#### Feed messages <a href="#uofnumberbettingservice-feedmessages" id="uofnumberbettingservice-feedmessages"></a>

All feed messages are generated by product 7 (wns). The format of the messages is the same as those generated by other producers (see section 3.3). The normal life cycle for a wns draw is in some rare circumstances draws are cancelled. A betstop and bet\_settlement might then be sent before the draw start. The markets in the settlement will then be voided and use an appropriate void reason.

*Feed messages from product 7 (wns):*

| **Time**                  | **Message**     | **Notes**                                                                                                |
| ------------------------- | --------------- | -------------------------------------------------------------------------------------------------------- |
| Midnight before the event | odds\_change    | Note that there isn't a fixture change message. In 99% of cases there is only one odds update per event. |
| Minute before draw start  | bet\_stop       | <p><br></p>                                                                                              |
| Sometime after draw       | bet\_settlement | <p><br></p>                                                                                              |

#### API - Number betting <a href="#uofnumberbettingservice-api-numberbetting" id="uofnumberbettingservice-api-numberbetting"></a>

Due to the physical differences in lottery draws compared to other sports, Numbers Betting has some different endpoints and responses. Self-service documentation of the API exists in <https://iodocs.betradar.com/?urls.primaryName=Unified%20Feed%20Numbers%20betting>.

*Number betting APIL endpoints*

<table data-header-hidden><thead><tr><th></th><th></th><th></th></tr></thead><tbody><tr><td><strong>HTTP</strong></td><td><strong>Endpoint</strong></td><td><strong>Description</strong></td></tr><tr><td>GET</td><td><pre><code>/wns/{language}/sport_events/wns:draw:{id}/fixture.xml
</code></pre></td><td>Look up for a single draw. No additional information is found here that doesn't exist in the schedule.</td></tr><tr><td>GET</td><td><pre><code>/wns/{language}/sport_events/wns:draw:{id}/summary.xml
</code></pre></td><td>Look up both the fixture and the result for a single draw. If event hasn't ended then result is omitted.</td></tr><tr><td>GET</td><td><pre><code>/wns/{language}/lotteries.xml
</code></pre></td><td>Full list of all lotteries (tournaments) that are considered relevant</td></tr><tr><td>GET</td><td><pre><code>/wns/{language}/lotteries/wns:lottery:{id}/schedule.xml
</code></pre></td><td>Get the list of draws for a given lottery. Only relevant lotteries that are in the future or have recently ended are shown. This is similar to the tournament schedule endpoint in the Sports API</td></tr><tr><td>POST</td><td><pre><code>/wns/recovery/initiate_request
?after=(timestamp)[&#x26;request_id=(x)][&#x26;node_id=(y)]
</code></pre></td><td>Perform recovery. Data is sent over the feed. See 4.6</td></tr></tbody></table>

*Lottery attributes*

| **Name**                 | **Description**                                                                                                                                                                     |
| ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| id                       | Unique identifier of the lottery                                                                                                                                                    |
| name                     | Name of the lottery                                                                                                                                                                 |
| sport                    | Sport element similar to Sports API                                                                                                                                                 |
| category                 | Category element similar to Sports API                                                                                                                                              |
| draw\_info.draw\_type    | Enum taking one of the values drum or rng. This indicates if the pick is performed using a drum or a random number generator.                                                       |
| draw\_info.time\_type    | Enum taking one of the values fixed or interval. Interval lotteries offers frequent draws.                                                                                          |
| draw\_info.game\_type    | String in the form "6/39". Where 6 indicates number of balls to be picked, while 39 is the number of balls used in the draw                                                         |
| bonus\_info.bonus\_balls | The number of bonus balls used in the draw                                                                                                                                          |
| bonus\_info.bonus\_drum  | Enumeration, either same or additional. If bonus drum is additional, it means that draws will be picked from a new drum, allowing the same balls to be picked from the regular draw |
| bonus\_range             | String in the form "1-49" indicating the range of values the bonus balls can take                                                                                                   |

*Fixtures attributes*

| **Name**                         | **Description**                                                                                                                                                                                                                                     |
| -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| id                               | Unique id of the draw                                                                                                                                                                                                                               |
| draw\_date                       | Date and time of the draw in ISO 8601 format. Time is specified in UTC time.                                                                                                                                                                        |
| lottery                          | Lottery element see (lottery attributes section)                                                                                                                                                                                                    |
| status                           | Enum taking a value of either open, closed, finished, canceled. Open means that the draw has not started yet. Closed means that the lottery is being played. Finished means that we have a result and canceled indicates that the draw was aborted. |
| draw\_result                     | Element for result if the draw is finished or canceled                                                                                                                                                                                              |
| draw\_result.draws.chronological | Boolean specifying if the draws are specified in the order they were picked (chronological) or sorted by value                                                                                                                                      |
| draw\_result.draws.draw\.name    | The name of the single draw in the form "draw\_3". If the lottery has bonus balls, this will be displayed as "draw\_b1".                                                                                                                            |
| draw\_result.draws.draw\.value   | The ball number of the draw.                                                                                                                                                                                                                        |

&#x20;


---

# 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/number-betting-service.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.