SportsDataIO maintains a database of event and betting data for the US sports market covering over 10 years. The coverage and total number of historical years available vary slightly by league and typically correspond to the year SportsDataIO started tracking each league.
Vault Access specifically enables access to Prior Season’s Team/Player/Game data. Clients can determine what the prior season year is by checking the Timelines and Current Season endpoints from the Utility Endpoint category in the integration guide for each league.
SportsDataIO Odds data will move to the Vault slightly earlier than the league data mentioned above. Please see “Other Important Points” below for more detail.
All historical data is available through SportsDataIO Vault
What’s Included:
How To Access:
Clients can use our existing API documentation to seamlessly integrate historical sports data into your workflow.
- Competition Feeds, Event Feeds, Fantasy Feeds, Game Lines (from betting feeds), and and Matchups/Trends/Splits (from betting feeds) for ALL leagues can be accessed via the same production API Key and Endpoints as your in season and live access.
- Following the same steps outlined in our Season Parameter Process Guide, customers can enter the desired year of data they wish to call within our existing endpoint catalogue and receive that year’s data delivered.
- Props and Futures Betting Feeds for the NFL, NBA, MLB, NHL, CFB, and Men’s College Basketball do have a different access point and API key. Please see the Exceptions to the Rule section below for more information.
What to know about the historical data:
The data structure for our historical data will match the same data structure and payload as you see while calling the in-season data.
- Please note that historical data can only be called one year at a time. We do not currently deliver ALL historical data in one payload. If you’d prefer to discuss other methods of delivery for historical data access, please contact sales@sportsdata.io.
- Once data is considered historical (out of season) it WILL NOT change. Please do not set up recurring jobs to pull historical data as that data will be the same for each call and should be stored locally in your own saved locations.
- If at any point you are having difficulties accessing this historical data, please contact support@sportsdata.io
Exceptions to the Rule:
For the most part Betting Feeds will all operate the same. When referencing the chart below - Anything with an “X” can still be accessed via the same productions API and Endpoints you are using for in season Betting Feeds.
- While working pulling data in a category/league market with X please refer to our dedicated guides listed below:
Anything with “A” should reference the instructions below to access Props and Futures Betting Feeds for the NFL, NBA, MLB, NHL, CFB, and Men’s College Basketball. This data now lives in our Betting Data Archive and requires a new API key and Endpoints. For Access to this historical betting data please contact sales@sportsdata.io .
Why are the sports marked “A” in a different location?
While expanding our Sportsbook and Betting Market coverage in 2024 we ended up with 500% more betting market coverage. To maintain best performance and speed for in season odds all Props and Futures older than 30 days (for the leagues indicated with “A” above) are moved to our data warehouse.
- This allows us to streamline our production data tables to ensure that live odds get to you, the user, as quickly as possible.
- All you need to do is make a call to a different endpoint with a new API key for historical data indicated with “A” above.
- This is currently in place for the Big Six Game Props, Team Props, Player Props League Futures, and Player Futures (NFL, MLB, NBA, NHL, CFB, CBB)
- Historical odds for Soccer, Golf, MMA, WNBA, and NASCAR remain in the production API.
How Do I Access this historical odds archive mentioned above?
Our Historical Odds endpoints connect directly to a new Data Warehouse.
- Our Historical Odds endpoints live in our Data Warehouse.
- Data Warehouse API callers will need to pass 3 parameters:
-
Season(e.g.2024) BettingMarketId-
SportsbookGroup(see this guide for how Sportsbook Group endpoints work if you are unfamiliar.)
-
For all Props, you can call the Props endpoint with the BettingMarketId of your choice:
For Futures, a dedicated endpoint exists with the same parameter requirements:
Here is a sample workflow for getting the BettingMarketId:
- Examine StartDate on a BettingEvent to see if it’s over 30 days old
- Assemble
BettingMarketIDlist for any markets you are interested in:- https://sportsdata.io/developers/api-documentation/ncaa-football#/endpoint/betting-markets-by-event
- You can also use the
ArchiveLocationfield, which returns the exact URL; just substitute{SportsbookGroupId}with an ID of your choice and{ApiKey}with your API key for the SportsDataIO Historical API product.
- Determine which
SportsbookGroup(s) for which you want to retrieve historical outcomes (see your My Account section for a list of available groups and ensure you are looking at your SportsDataIO API Historical product. - Loop BettingMarketID and SportsbookGroup, call endpoint and store data
Data Structure
- Data warehouse API responses have the exact same schema/shape as the production BettingMarket (“line movement”) endpoints.
- See for example https://sportsdata.io/developers/api-documentation/mlb#betting-market with any BettingMarketId (e.g. 4010995) for exactly how this will look.
- You should be able to take your existing production code and use it for accessing the data warehouse as it is completely identical in its response format.
- Per the above, only the call parameters differ.
- Per the above, only the call parameters differ. All calls start at the betting_market AND will deliver the betting_outcomes plus line movement since the data is static and will no longer change moving forward.
Other Important Points
- By "30 days old", we mean the StartDate on BettingEvent must be <= 30 days ago.
- The full archive has all available historical data, even older than 365 days.
- For Game type BettingEvents (for aggregated odds like Props, Futures, Game Lines etc.) this is easy: it means the date the game started.
- For Futures, however, this usually means the odds will be historical 30 days after the season ends, since the market StartDate can vary based on a variety of factors.
- If in doubt, check the live endpoints first; if they are not present, they are in the Historical endpoints.
- Our Team Roster’s endpoints are overwritten each season. If you’d like to access historical Roster data, use the Player Stats endpoints to identify which team’s players recorded those stats on.
Note: Access to previous seasons for non-odds historical Vault data and enabling historical betting lines endpoints is managed by SportsDataIO staff within your account's settings. Please contact sales@sportsdata.io to discuss access if you would like to enable access.
Comments
0 comments
Article is closed for comments.