Donbest XML

FAQ


Basics | RESTful API | Streaming | Samples | Betting Terminology

How much does it cost?

The cost depends entirely on your needs and can range from as little as $100 per mont to as much as $10,000 per month. Please fill out the inquiry form at https://secure.donbest.com/shop/feed_registration.html and one of our representatives will contact you with a quote in short order.

What sports/leagues do you cover?

We cover all major North American sports, specifically NFL, NBA, MLB, NHL, NCAA Football, NCAA Basketball. We also cover MMA/UFC, boxing, tennis, NASCAR, and the popular International soccer leagues.

What sportsbooks are available?

Click HERE to see the list.

What are the delivery methods you offer?

The content can be delivered either through RESTful API (XML), or through the streaming messaging system ActiveMQ. If your subscription is for real-time updates, it's recommended that you program with the messaging system. However, if your subscription is for delayed updates, we currently only offer the RESTful method.

What is the advantage of the streaming method?

Instead of polling the RESTful every so often, we actually push the updates to you. This greatly reduces overhead on your end, and also on ours. Moreover, the updates are delivered in real-time with minimal delay.

How accurate is the data?

We have staff who are constantly monitoring the accuracy of the lines and scores, as this information appears both on our Donbest Premium/Express odds service as well as in our feeds. Our North American data is considered the most accurate available on the market, and we dedicate significant resources so as to ensure that we continue to merit elite status. However, with the immense amount of data being handled daily, there will occasionally be errors here or there. That's the nature of the beast.

What's the timezone you use in the feed?

UTC.

What is the difference between Opening, Pervious, Current and Closing lines?

Opening Lines are just that; they are the lines that a specific sportsbook opens with. Of course, these lines can change over time. Current Lines show the line that is currently being posted by a specific sportsbook. Previous Lines are the most recent lines before the Current Line. Closing Lines show the last available line offered before betting closed.

As an aside, note that in the event that a line is removed, or "taken down" as we prefer to say, you will see display values of Home="0" & Away="0".

Aside from FG lines, do you offer 1H, 2H, first five, periods/quarter?

It varies from sportsbook to sportsbook. Some will have these lines and others will not.

What about futures?

Yes, they are available!

How come I see two events for the same game?

For NBA, NFL, NCAA football, and NCAA basketball, there may be in-game lines for certain games. The in-game lines only are available during the game, whereas the regular line will cease to move the moment the game gets underway.

How can I tell which one is in-game line?

There are 2 ways to determine if it's in-game line:

1. Through the group header
2. In-game lines are prefixed with "9"

What is the "consensus" line?

The consensus line is an amalgamated line from several books so you get the average lines instead of a particular book line.

Can we query for previous days lines and scores?

We do not accommodate back tracking at the moment.













RESTful XML samples

Schedule
Score
Odds - MLB
Odds - NBA
Odds - NFL
Odds - NCAA Football
Odds - NCAA Basketball
Odds - CFL
Odds - NHL
Odds - WNBA
Odds - Arena Football
Odds - Boxing
Odds - Soccer
Odds - Tennis
Odds - Golf


RESTful API samples

Coming soon

Streaming samples

The ActiveMQ Connectivity page has lots of resources on how to build a listener in various languages.

C# - ActiveMQ Listener

Do I need to generate a token to listen to the topics?

You do not need to generate a token in order to listen to the topics.

However, the service is protected by IP address. So we will need to add your IP to our white list.

What's the best practice to use with this streaming technology?

We recommend that you do a bootstrap for schedules/scores using the RESTful feed when your application first loads. Then listen to the topics for changes.

What is a token and why it's required?

The token is required to validate that you are allowed to use our service.

Does the token expire?

The token is bound to your IP addrees. You will not have to re-generate the token unless your IP changed.

How frequent can we poll the data?

We recommend no less than 10 seconds.





















Action

A wager of any kind.

Book

An establishment that accepts wagers on the outcome of horse racing and sporting events. Also commonly referred to as a bookie (person), bookmaker or sportsbook.

Bankroll

Your available gambling money.

Buy Points

Buy Points means that you can move the point spread so that you give away fewer points with the favourite or get more points with the underdog, for both american football and basketball. To do this you must pay an extra 10% for each point you buy in your favour. For NFL and NCAA football, you would pay an additional 15% to buy on or off of 3 points - also know as Key Points. And if you buy through 3 points, you would pay an additional 20%. NOTE: There are usually no Key Points for basketball. You would pay a flat 10% for each 1/2 point you buy. An example of how to buy off of 3 points: the Baltimore Ravens (-3) are 3 point favourites. To buy 1/2 point and make them a 2.5 point favourite, you would need to lay 125 to win 100.

Buy Point Chart (Football Key Points)

Buy 1/2 point to 3 100/125
Buy 1/2 point off 3 100/125
Buy 1 point to 3 100/135
Buy 1 point off 3 100/135
Buy 1/2 point any other 100/120
Buy 1 point any other 100/130

Cover

To bet the spread by the required number of points. If such occurs you have "covered the spread."

Dime

One thousand dollars.

Dog

The underdog in any betting proposition.

East Coast Line

Mainly used in hockey, which has a split-goal line e.g. - Philadelphia Flyers (1 - 1 ) favourite over the LA Kings as opposed to goal spread plus moneyline (-1/2 -180).

Edge

Advantage

Exotic Wager

Any bet other than a straight bet, i.e., parlays, teasers, if bets, reverses, round robin, round robin box reverses, etc.

Futures

Odds posted on the winners of various major sport championships in advance of the event, including the Super Bowl, the World Series, the Stanley Cup and the NBA Championship.

Handle

The sum of all wagers collected for a particular event or over a specific time period by a bookmaker.

Hedging

Placing bets on the opposite side in order to cut losses or guarantee winning a minimal amount of money. (also see 'middling')

Holding Your Own

Neither winning or losing, just breaking even.

Hook

A half point added to football and basketball betting lines.

Juice

Another name for vigorish, or the tax that bookmakers charge for each wager. Some books may offer 'no juice' or free sports betting offers to entice potential bettors to join their company.

Line

The listed odds on a game (points or money line).

Lock

Easy winner, can not lose.

Longshot

A team or horse that is unlikely to win.

Middles (or Middling)

To win both sides of the same betting proposition; betting the favourite team at -1.5 with one bookmaker and then taking +3.5 with another bookmaker; the game ends up with the favourite winning by exactly 3 points, you have then "middled the game".

Money Line

A moneyline is offered when no handicap is given, such as a point spread or run line, and the odds are not therefore fixed. Payouts are then based on true odds rather than fixed odds. The favourite and underdog are given odds to win a game or fight.

The minus sign (e.g.-130) always indicates the favourite and the amount you must bet to win 100. The plus sign (e.g.+110) always indicates the underdog and the amount you win for every 100 bet. Therefore based on the above moneyline, you bet 130 to win 100 on the favourite. For the underdog, you win 110 for every 100 bet.

Newspaper Line

The betting line which quite often appears in the daily newspapers. The lines are only approximate and are quite often inaccurate and misleading.

Odds On Favourite

A horse, team, or individual so favoured by the public that the odds are less than even.

Official Line

The line that the bookmaker uses for wagering purposes. The line which comes from Las Vegas is quite often referred to as the official line; however, the line that your bookie offers you is actually your "official line."

Overplay

An advantage for the bettor in which the price on a given wager is greater than the real probability of its success.

Over & Under

A wager for the total score by both teams will more or less than the total posted by the sportsbook.

Parlay

The number of teams in the parlay must all hit or the parlay loses. 2-team parlay pay 13-5 odds. 3-team parlay pay 5-1 odds. 4-team parlays pay 8-1 odds.

Parlay Cards

Wagers on a minimum of 3 and up to 15 propositions; the more you pick, the higher the payoff.

Pick

Occasionally, there will be no favourite on a game. In this instance the game is said to be a pick and you can have a bet of 10/11 (bet 110 to win 100) on either team.

Pointspread

The pointspread - also called "the line" - is used as a margin to handicap the favourite team. The oddsmaker - also called the handicapper - "gives" points (or goals) to the underdog - for betting purposes only. The bettor must take either the favourite or the underdog. The favourite is always indicated by a minus sign (e.g. -8.5) and the underdog by a plus sign (e.g.+8.5). For betting purposes, the outcome of the game is determined by taking the actual game score and finding the difference between the scores of the two teams playing (called the pointspread or just the "spread").

For example - the Detroit Lions are 8 point favourites over the New York Giants (an 8 point spread shown as -8 beside Detroit on our "lines" page). If the final score is Detroit 20 New York 13, then the actual game score "spread" is 7 points (20 minus 13). In our example if you took New York (called the "dog"), you would win the bet since Detroit had to win by 9 points or more to "cover the spread". Detroit needed 2 more points to "cover" since if the game landed right on the "spread" of 8 points it would be called a "push" (similar in concept to a tie in Moneyline wagering, which is also called a push) and it would be "no action" (no bet and money held in your account to cover the wager is released back into your available balance). If the "spread" is put in at a half point (e.g. -8.5 for the favourite Detroit) by the sportsbook handicappers then there can be no "push." In this case, there is "action" at any final game score pointspread. In a pointspread, you must wager 11 to win 10 (21 is returned to the winner). 10/11 is the standard for pointspread bets on most sports.

Post Time

The scheduled starting time.

Proposition Bet

A wager on a particular aspect of the game such as how many field goals will be made.

Puckline

Hockey combines both a handicap/spread and odds. This is called the puck line.

sample line:
Boston +1 (-110)
Detroit -1.5 (-110)

The favourites are the Detroit Red Wings, who are giving the Boston Bruins 1.5 goals. To win the bet, Detroit would have to win the game by 2 goals. When placing this bet you are getting even money, which means that for every 110 you wager, you will win 100. If you are betting on Boston, you will receive a 1.0 goal handicap, meaning that if Detroit wins by 1 goal the game is a push. If the game ends in a tie or Boston wins, then you win the bet. The odds again are at -110.

Push

If the result of a game lands exactly on the pointspread or is a tie in the case of betting a moneyline, or if the exact score of the game matches exactly the sportsbook's posted game total (Total), then the game is a "Push" or "No Action" and all wagers are normally released.

Round Robin

A form of parlay betting in which we wager various combining team wagers. A three-team robin is team 1 to 2, 1 to 3, and 2 to 3. A four-team robin is team 1 to 2, 1 to 3, 1 to 4, 2 to 3, 2 to 4, and 3 to 4. Five-team, etc.

Run Line

A line used when wagering on baseball.

Side

When one side of a wager wins and the other side ties.

Slip

A typical receipt of a wager or wagers placed at a land-based sportsbook.

Steam

When a betting line starts to move quite rapidly. Most 'steam games' do not necessarily reflect the 'right side', but are games that the mass of bettors somehow decide to key on.

Streak

A consecutive string - usually at least several - of winning bets.

Taking

Wagering on the underdog; taking the odds.

Totals

Total combined point/runs/goals scored in a game; In baseball, if either of the two listed starting pitchers don't go the distance, the bet is automatically canceled.

Value

Getting the best odds on a betting proposition; the highest possible edge.

Vig

The house's commission on a wager. Formally known as 'vigorish'.

Wager

Any Bet.

Token

Documentation

Versions