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.
Table of contents:
Feed messages
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 |
|
Sometime after draw | bet_settlement |
|
API - Number betting
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/wns.
Number betting APIL endpoints
HTTP | Endpoint | Description |
|---|
GET | sports/(lang)/sport_events/(id)/fixture.xml | Look up for a single draw. No additional information is found here that doesn't exist in the schedule. |
GET | sports/(lang)/sport_events/(id)/summary.xml | Look up both the fixture and the result for a single draw. If event hasn't ended then result is omitted. |
GET | wns/(lang)/lotteries.xml | Full list of all lotteries (tournaments) that are considered relevant |
GET | wns/(lang)/lotteries/(id)/schedule.xml | 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 |
POST | wns/recovery/initiate_requestt?after=(timestamp)[&r equest_id=(x)][&node_id=(y)] | Perform recovery. Data is sent over the feed. See 4.6 |
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. |
