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 wns (World Number Service) messagesNumbers Betting messages, you need to select what lottery types you want to receive from the ctrl feed options page. Table of contents: Feed messagesAll 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 bettingDue 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. |
|