Frequently Asked Questions
General API Questions
For information on costs for our various packages please head to:
https://rapidapi.com/therundown/api/therundown/pricing
We do provide discounts for longer term subscriptions so please get in contact for more details
By default, no overages are charged for our free BASIC plan, meaning that the limit cannot be exceeded.
Overages are chargeable for our paid plans, which allows users the flexibility to exceed their quota when necessary. If you would prefer to instead have a HARD limit on your plan then please contact us.
Technical API Questions
A request is a single HTTP request to an API endpoint. Different endpoints can provide different responses containing various sets of information. Please refer to the documentation to view a complete list of available endpoints and their responses.
Here are some examples of what 1 request might look like, along with endpoints
- Using the /sports/{sport-id}/events endpoint, a single request would return the full game odds for all events that both have odds and have not yet started;
- Using the /sports/{sport-id}/events/{date} endpoint, a single request would return all events for a particular sport on a date, regardless of whether or not they have odds available or if they have started. Using `?include=scores` will return additional information such as the score and event status. Using both `?include=scores&include=all_periods" will return odds for all available event periods instead of just the full game;
- Using the /delta endpoint, a single request would return only events which have changed since the previous request, for instance a change in odds. Note that A 400 response will be returned if too many events have been updated since the last request. If this happens, you should use any of the events endpoints (events by sport by date) to retrieve a full snapshot of the events before using the delta endpoint again with the updated last_id.
The /delta endpoint returns all changes since the last_id value.
The endpoint can, however, be filtered by sport_id parameters. If the request is filtered by sport_id (ie: the ?sport_id=
It is recommended to use the sports by date endpoint to first get a snapshot of all the sports, and then use the delta endpoint to periodically update.
A 400 response will be returned if there are too many events that have been updated, which is not necessarily the same as the number of updates. For example, if a single event receives multiple updates, only the single event is still returned. The limit to the number of events in a single /delta request is currently 150, although this may change in the future, so please be prepared to handle this accordingly.
TheRundown Website Questions
We have created a tool which allows the user to see an average of the odds shown by the bookmakers which we display. Due to the fact that each bookmaker has a different margin (also known as 'Juice' or 'Vigorish'), simply taking a straight average of the odds would provide misleading results. Instead, we have removed the margin each time which shows us each bookmaker's estimation of the true odds at that time, and from this we derived the following:
No Juice
This average reflects the average of all bookmakers' odds after their margin, or juice has been removed and is the truest reflection of the market consensus. If your bets are at odds consistently higher than this figure you stand a good chance of making profit in the long term.
Dime Line
Once bookmakers have calculated their estimated true odds, the standard margin that they then apply is known as the 'Dime Line'. If both sides of a spread are estimated at -100, then applying the Dime Line margin will reduce their offered price to -110 each side. This average reflects this margin and allows the user to see how their bookmaker stacks up against others.
Reduced Juice
Some bookmakers offer a margin lower than that of the Dime Line , in other words, more attractive odds. There are those that simply offer these odds as part of their model and others that may only provide reduced odds on specific markets or to certain customers. The standard 'Reduced Juice' will reduce each side of the spread from -100 to -105. You will be able to use this average to see how your reduced juice bookmaker compare against others as well as recognising the fact that the these bookmakers should be part of your armoury as they offer consistently better odds
Extra Juice
There are bookmakers that offer inferior odds to that of the Dime Line and this average reflects that. Whilst there may be reasons for using bookmakers with such odds, such as reliability or bonus offering, in general they should be avoided. The higher the margin that a bookmaker applies, the more difficult it becomes to earn money from betting.