Frequently Asked Questions

General API Questions

1How can I trial the API?
We offer a 2 week trial consisting of 10,000 requests/day for free. If you would like to take advantage of this offer then please send an email to: [email protected]
2Where can I find TheRundown's API documentation?
3Where are your prices?

For information on costs for our various packages please head to:

We do provide discounts for longer term subscriptions so please get in contact for more details

4Do you charge for exceeding the plan limits?

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

1What exactly is a request to the API?

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.

2Should I use the `teams` or `teams_normalized` field in the response?
We do not recommend using the `teams` value in the response, but the `teams_normalized` field. The `teams_normalized` will have consistent team names.
3How does the /delta endpoint work?

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= is sent in the request), then only events for that sport that have changed since the provided delta_last_id will be returned.

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.

4Why might I receive a 400 response when using the /delta endpoint?

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

1 How do I use the 'Average Odds' column?

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.