NFL - Betting Splits v1

Frequently Asked Questions
API API Version
NFL Advanced Insights - Betting Splits v1
Note: Authentication is required for all API calls.
## Betting Splits by Game ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("{your_api_key}") http =, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("") conn.request("GET", "/bettingsplits/nfl/trial/v1/en/game/7e5bf1c5-e4dd-4f47-a4ec-2b4d55350aaf?api_key={your_api_key}") res = conn.getresponse() data = print(data.decode("utf-8")) ``` ```shell curl -L "{your_api_key}" ``` > The above command returns json structured like this. This endpoint retrieves Betting Splits by Game.`{access_level}`/`{version}`/en/game/`{game_id}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as Trial (trial) or Development (development). | | `version` | Version number of the API you are accessing (Current Version: v1). | | `game_id` | Id of a given game. | | `your_api_key` | Your API key. | ## Frequently Asked Questions

Q: What is the Date format?

A: When we present date only values we present these in the ISO 8601 standard format.
ex: 2013-04-03
We use these for attributes that have date and no time (such as birthdate). For more information:

Q: What time zone are the date time fields presented in?

A: All of our Date/Time attributes are in UTC, presented in the ISO 8601 standard format.
ex: 2013-04-03T18:15:00+00:00
For more information:

Q: How do the betting splits behave before and during games?

A: Data updates every 6 hours if the game is scheduled for the future. Data updates every 15 minutes on game day until 1 hour before the game begins. Data updates every 5 minutes between 1 hour - 15 minutes before the game begins. Data updates every 1 minute starting 15 minutes before the game, and continues throughout the game and stops when the game is over.

Q: What data can I expose?

A: The ticket percentage and stake percentage can be exposed, but the number of bets cannot. Number of bets can be used to do internal calculations, and to say which is the most bet on game, but the raw number is not allowed to be exposed to your end user.

Q: Where does the data come from?

A: Sportradar has an arm of our business that works with global bookmakers on their integrity – monitoring bets, helping detect fraud, etc. To do this, we ingest the tickets that come in for these bookmakers. Those tickets are aggregated, and the numbers are reflected in the betting splits feed.

Q: How come Betting Splits I see released by individual bookmakers are different percentages from those in the feeds you have?

A: Our Betting Splits feeds don’t represent a single book, but rather an aggregation of them. When it comes to something like Betting Splits, you’re always going to have different information depending on your source.

Q: How much data should I expect to see?

A: Please reach out to us and we can provide information on how much data you should expect to see. On the whole, the amount of data coming in for soccer will be substantially higher than any other sport.

Return to top

Docs Navigation