NASCAR API Documentation
This is the documentation for our NASCAR API. To get a more comprehensive understanding of what feeds we have to offer and the data points we deliver via our endpoints, we encourage you to explore the following resources:
All of our API endpoints can be accessed via an HTTP GET request using your API key.
The API key can be passed either as a query parameter or using the following HTTP request header.
Ocp-Apim-Subscription-Key: {key}
Competition Feeds
Teams, Players & Rosters
Available Endpoints
Subfeed
Teams, Players & Rosters
Returns all drivers with number, team, birthday, birthplace, manufacture, sponsors, and crew chief.
Teams, Players & Rosters
Returns the specified driver with number, team, birthday, birthplace, manufacture, sponsors, and crew chief.
Teams, Players & Rosters
Returns all active drivers with number, team, birthday, birthplace, manufacture, sponsors, and crew chief.
Driver Profiles - All
Returns all drivers with number, team, birthday, birthplace, manufacture, sponsors, and crew chief.
Endpoint Notes
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
Driver Profiles - by Driver
Returns the specified driver with number, team, birthday, birthplace, manufacture, sponsors, and crew chief.
Endpoint Notes
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
driverid
integer
true
Unique FantasyData Driver ID.
Example:
80000268.Drivers - by Active
Returns all active drivers with number, team, birthday, birthplace, manufacture, sponsors, and crew chief.
Endpoint Notes
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
Venues & Officials
Tracks
Returns a list of all tracks in the specifed season.
Endpoint Notes
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
season
string
true
Year of the season.
Examples:
Examples:
2015, 2016.Utility Endpoints
Available Endpoints
Subfeed
GET
Betting Metadata
Utility Endpoints
Returns the list of MarketTypes, BetTypes, PeriodTypes, OutcomeTypes, and ResultTypes to map the IDs to descriptive names. Also includes a list of the MarketType, BetType & PeriodType combinations which we will have resulting for.
Utility Endpoints
Returns a list of all available sportsbooks with their associated unique IDs.
Betting Metadata
Returns the list of MarketTypes, BetTypes, PeriodTypes, OutcomeTypes, and ResultTypes to map the IDs to descriptive names. Also includes a list of the MarketType, BetType & PeriodType combinations which we will have resulting for.
Endpoint Notes
Call Interval:
15 Minutes
Return Type:
BettingEntityMetadataCollection
Included Data Tables:
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
Series
Returns the three national series with their respective SeriesID's.
Endpoint Notes
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
Sportsbooks - by Active
Returns a list of all available sportsbooks with their associated unique IDs.
Endpoint Notes
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
Event Feeds
Schedules & Game Day Info
Schedules
Returns a full schedule for the specified season with race information such as track, broadcast, winner, pole winner, scheduled laps, etc.
Endpoint Notes
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
season
string
true
Year of the season.
Examples:
Examples:
2015, 2016.Scores & Game State
Available Endpoints
Subfeed
Final Only (No Game State)
Returns the final leaderboard for a specified race, including limited driver information and race statistics.
Final Only (No Game State)
Returns the final leaderboard for a specified race, including driver information and race statistics.
Live & Final (With Game State)
Returns the leaderboard for a specified race, including race statistics.
Live & Final (With Game State)
Returns the leaderboard for a specified race, including race statistics. All of which is delivered during and after.
Leaderboard (Basic) [Final]
This is the Final version of this endpoint. For live data, please use Leaderboard (Basic).
Returns the final leaderboard for a specified race, including limited driver information and race statistics.
Endpoint Notes
Call Interval:
30 Seconds
Return Type:
RaceResultBasic
Included Data Tables:
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
raceid
integer
true
Unique FantasyData Race ID.
Example:
1, 2, etc.Leaderboard [Final]
This is the Final version of this endpoint. For live data, please use Leaderboard [Live & Final].
Returns the final leaderboard for a specified race, including driver information and race statistics.
Endpoint Notes
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
raceid
integer
true
Unique FantasyData Race ID.
Example:
1, 2, etc.Leaderboard (Basic)
Returns the leaderboard for a specified race, including race statistics.
Endpoint Notes
Call Interval:
30 Seconds
Return Type:
RaceResultBasic
Included Data Tables:
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
raceid
integer
true
Unique FantasyData Race ID.
Example:
1, 2, etc.Leaderboard [Live & Final]
Returns the leaderboard for a specified race, including race statistics. All of which is delivered during and after.
Endpoint Notes
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
raceid
integer
true
Unique FantasyData Race ID.
Example:
1, 2, etc.Player Feeds
Betting Feeds
Game Lines
Available Endpoints
Subfeed
GET
Race Odds
Pre-Game Lines
Returns pre-race odds for a specified race. Only returns the most recently seen odds, not inclusive of line movement.
Pre-Game Lines Plus
Returns pre-race odds for a specified race. Only returns the most recently seen odds. This is inclusive of line movement; as it is best suited for viewing historical odds, its cache time is slower than the Race Odds endpoint.
Race Odds
Returns pre-race odds for a specified race. Only returns the most recently seen odds, not inclusive of line movement.
Endpoint Notes
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
Raceid
integer
true
Unique FantasyData Race ID.
Example:
1, 2, etc.Race Odds Line Movement
Returns pre-race odds for a specified race. Only returns the most recently seen odds. This is inclusive of line movement; as it is best suited for viewing historical odds, its cache time is slower than the Race Odds endpoint.
Endpoint Notes
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
Raceid
integer
true
Unique FantasyData Race ID.
Example:
1, 2, etc.Props
Available Endpoints
Subfeed
Props
Returns a list of current betting events on the specified date, used to retrieve betting market data via the Betting Markets by Event endpoint. Includes all available market types (e.g., Player Props, Team Props).
Props
Returns BettingEvents for the specified season, from which Betting Market data can be gathered via the Betting Markets by Event endpoint, for all available Betting Market types (e.g. Player Props, Team Props.)
Props
Returns the markets of all available types (e.g. Player Props, Team Props) and available outcomes for a given BettingEventID.
Props
"Returns markets and available outcomes for a given event and market type.
NOTE: This is a lighter call than by BettingEventID as it only includes markets tagged with the specific MarketType, a full list of which is available for each sport in its Betting Metadata endpoint."
Props
Returns the markets of all available types (e.g. Player Props, Team Props) and available outcomes for a given GameID.
GET
Betting Market
Props Plus
"Returns full line movement for a given BettingMarket.
NOTE: Due to the sheer size of the output and the level of detail, it is intended for historical data purposes and NOT for the most up-to-the-second lines."
Betting Events - by Date
Returns a list of current betting events on the specified date, used to retrieve betting market data via the Betting Markets by Event endpoint. Includes all available market types (e.g., Player Props, Team Props).
Endpoint Notes
Call Interval:
15 Minutes
Return Type:
BettingEvent[]
Included Data Tables:
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
date
string
true
The date of the race(s).
Examples: 2023-02-19.
Betting Events - by Season
Returns BettingEvents for the specified season, from which Betting Market data can be gathered via the Betting Markets by Event endpoint, for all available Betting Market types (e.g. Player Props, Team Props.)
Endpoint Notes
Call Interval:
1 Hour
Return Type:
BettingEvent[]
Included Data Tables:
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
season
string
true
The season to get BettingEvents. Valid entries are formatted as years such as
2023Betting Markets - by Event
Returns the markets of all available types (e.g. Player Props, Team Props) and available outcomes for a given BettingEventID.
Endpoint Notes
Call Interval:
10 Minutes
Return Type:
BettingMarket[]
Included Data Tables:
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
include
string
false
- available
- unlisted
This parameter indicates which
Important Note: the default parameter of
Possible values include:
BettingOutcome records to return in the payload. By default, this endpoint only returns available outcomes, excluding the unlisted bets. Important Note: the default parameter of
available is much faster and provides the best performance. Passing unlisted will return unlisted odds, but these are cached for much longer and may be several minutes old. For best performance, the default parameter is highly recommended. Possible values include:
available - excludes any betting outcomes that have been removed/unlisted by the respective sportsbook. This is more lightweight and delivers odds much faster than using unlisted. unlisted - includes the most recently available betting outcome per sportsbook, for each listed market, even those outcomes are expired/unlisted or otherwise unavailable from the respective sportsbook. This is a far heavier payload, and it's cached for much longer than available. URL Template Parameters
Parameter Name
Type
Required
Value
eventId
string
true
The EventId of the desired event/game for which to pull all betting markets (includes outcomes/bets).
Betting Markets - by Market Type
"Returns markets and available outcomes for a given event and market type.
NOTE: This is a lighter call than by BettingEventID as it only includes markets tagged with the specific MarketType, a full list of which is available for each sport in its Betting Metadata endpoint."
Endpoint Notes
Call Interval:
1 Minute
Return Type:
BettingMarket[]
Included Data Tables:
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET
https://api.sportsdata.io/v3/nascar/odds/json/BettingMarketsByMarketType/{eventID}/{marketTypeID}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
include
string
false
- available
- unlisted
This parameter indicates which
Important Note: the default parameter of
Possible values include:
BettingOutcome records to return in the payload. By default, this endpoint only returns available outcomes, excluding the unlisted bets. Important Note: the default parameter of
available is much faster and provides the best performance. Passing unlisted will return unlisted odds, but these are cached for much longer and may be several minutes old. For best performance, the default parameter is highly recommended. Possible values include:
available - excludes any betting outcomes that have been removed/unlisted by the respective sportsbook. This is more lightweight and delivers odds much faster than using unlisted. unlisted - includes the most recently available betting outcome per sportsbook, for each listed market, even those outcomes are expired/unlisted or otherwise unavailable from the respective sportsbook. This is a far heavier payload, and it's cached for much longer than available. URL Template Parameters
Parameter Name
Type
Required
Value
eventID
string
true
The EventId of the desired event/game for which to pull all betting markets (includes outcomes/bets).
marketTypeID
string
true
The Market Type ID of the desired MarketTypes to pull. Some common types include: 1 for Race Lines, 2 for Driver Props, 3 for Head to Head Props, 4 for Group Props, 6 for Race Props
Betting Markets - by Race
Returns the markets of all available types (e.g. Player Props, Team Props) and available outcomes for a given GameID.
Endpoint Notes
Call Interval:
10 Minutes
Return Type:
BettingMarket[]
Included Data Tables:
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
include
string
false
- available
- unlisted
This parameter indicates which
Important Note: the default parameter of
Possible values include:
BettingOutcome records to return in the payload. By default, this endpoint only returns available outcomes, excluding the unlisted bets. Important Note: the default parameter of
available is much faster and provides the best performance. Passing unlisted will return unlisted odds, but these are cached for much longer and may be several minutes old. For best performance, the default parameter is highly recommended. Possible values include:
available - excludes any betting outcomes that have been removed/unlisted by the respective sportsbook. This is more lightweight and delivers odds much faster than using unlisted. unlisted - includes the most recently available betting outcome per sportsbook, for each listed market, even those outcomes are expired/unlisted or otherwise unavailable from the respective sportsbook. This is a far heavier payload, and it's cached for much longer than available. URL Template Parameters
Parameter Name
Type
Required
Value
raceID
integer
true
The RaceID of the desired race for which to pull all betting markets (includes outcomes/bets).
Betting Market
"Returns full line movement for a given BettingMarket.
NOTE: Due to the sheer size of the output and the level of detail, it is intended for historical data purposes and NOT for the most up-to-the-second lines."
Endpoint Notes
Call Interval:
15 Minutes
Return Type:
BettingMarket
Included Data Tables:
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
marketId
string
true
The MarketId of the desired market for which to pull all outcomes/bets.
Fantasy Feeds
Projections
Available Endpoints
Subfeed
Legacy Projections
Returns projected race stats for each driver in a specified race for races in the 2020 season or prior. For the 2021 season and beyond, this endpoint is used for DraftKings DFS driver salaries.
Projected Player Race Stats - by Race
Returns projected race stats for each driver in a specified race for races in the 2020 season or prior. For the 2021 season and beyond, this endpoint is used for DraftKings DFS driver salaries.
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
DriverRaceProjection[]
Included Data Tables:
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
raceid
integer
true
Unique FantasyData Race ID.
Example:
1, 2, etc.Salaries, Stats & Points
Available Endpoints
Subfeed
Points & Stats
Returns fantasy points scored by each player in a specified race.
Fantasy Points - by Race
Returns fantasy points scored by each player in a specified race.
Endpoint Notes
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
raceid
integer
true
Unique FantasyData Race ID.
Example:
1, 2, etc.