2017 sportradar official nascar statistics feeds...official nascar statistics feeds 2017 season...

Updated 08.29.17

1 SPORTRADAR NASCAR STATISTICS FEEDS

Official NASCAR Statistics Feeds

2017 Season

Updated 08.29.17


Table of Contents

NASCAR Statistics Feeds................................................................................................................................3

Series & Event Information.............................................................................................................................4

Race Information................................................................................................................................................5

Track Information...............................................................................................................................................7

Car Information....................................................................................................................................................9

Driver Information...........................................................................................................................................11

Team Information............................................................................................................................................13

Practice Statistics...........................................................................................................................................14

Qualifying Statistics........................................................................................................................................15

Race Statistics..................................................................................................................................................16

Season Statistics.............................................................................................................................................17

Driver Standings...............................................................................................................................................18

Rookie Standings.............................................................................................................................................19

Manufacturer Standings...............................................................................................................................20

Owner Standings.............................................................................................................................................21

Frequently Asked Questions.......................................................................................................................22

Document Change History...........................................................................................................................24

Updated 08.29.17


NASCAR Statistics Feeds

We package our comprehensive stats collection into the following feeds, each focused on serving specific information needs:

Daily Change Log – information on any changes made to race information, race results, driver information, track information, or standings

Driver Standings – provides detailed driver standings and season statistics, including starting position, finishing position, and laps completed averages

Driver Statistics – provides seasonal statistics for all drivers, broken out by track type, track name, and race name

Drivers – provides detailed driver information, including information regarding their cars and teams

Entry List – provides information regarding all drivers scheduled to attempt to qualify for a race

Manufacturer Standings – provides standings information for manufacturers within the series

Owner Standings – provides standings information for car owners within the series

Practice Leaderboard – provides practice information for all drivers entered in the field including sequence, speed, time, and finish position

Qualifying Leaderboard – provides qualifying information for all drivers entered in the field including fastest speed, time, and finish position

Race Leaderboard– provides detailed information concerning a drivers race performance during and after the race

Rookie Standings – provides the same level of detail as the driver standings feed, but only rookie drivers appear

Schedule – provides detailed information regarding all events associated with the series’ season

Starting Grid – provides the official start order of the race

Tracks – provides detailed information regarding all tracks within the Sprint Cup, Xfinity, Camping World and Monster Energy Nascar Cup race series

Updated 08.29.17


Series & Event Information

Stat Feeds Element Attribute Format

Event Id Schedule event id GUID Event Name Schedule event name String Event Start Date Schedule event start_date Date

Season Id

Daily Change Log

season id GUID

Driver Standings Driver Statistics Drivers Manufacturer Standings Owner Standings Rookie Standings Schedule

Season Year

Daily Change Log

season year Integer


Series Alias

Daily Change Log

series alias String


Series Id

Daily Change Log

series id GUID


Series Name

Daily Change Log

series name String


Updated 08.29.17


Race Information


Actual Distance Race Leaderboard race actual_distance Decimal

Actual End Time Race Leaderboard race start_time DateTime Schedule

Actual Start Time Race Leaderboard race end_time DateTime Schedule Average Speed Race Leaderboard race avg_speed Decimal Broadcast - Cable Schedule broadcast cable String Broadcast - Internet Schedule broadcast internet String Broadcast - Network Schedule broadcast network String Broadcast - Radio Schedule broadcast radio String Broadcast - Satellite Schedule broadcast satellite String

Chase Race

Entry List

race chase_race Boolean Qualifying Leaderboard Race Leaderboard Schedule Starting Grid

Comments Race Leaderboard comments String

Condition

Entry List

race condition String Practice Leaderboard Qualifying Leaderboard Race Leaderboard Starting Grid Note: Please see the FAQ section for more information.

Distance

Entry List

race distance Integer

Practice Leaderboard Qualifying Leaderboard Race Leaderboard Schedule Starting Grid

Elapsed Time Race Leaderboard race elapsed_time String Flag State – Beneficiary Race Leaderboard beneficiary String Flag State – Comments Race Leaderboard comments String Flag State – Lap Race Leaderboard flag lap Integer Flag State – Sequence Race Leaderboard flag sequence Integer Flag State – State Race Leaderboard flag flag_state String

Id

Daily Change Log

race id GUID

Entry List Qualifying Leaderboard Race Leaderboard Schedule Starting Grid

Laps

Entry List

race laps Integer


Laps Completed Race Leaderboard race laps_completed Integer Lead Changes Race Leaderboard race lead_changes Integer Margin of Victory Race Leaderboard race victory_margin Decimal

Name Daily Change Log race name String Driver Statistics record race_name

Updated 08.29.17


Entry List

race name


Number

Entry List

race number Integer


Number of Caution Laps Race Leaderboard race caution_laps Integer Number of Cautions Race Leaderboard race cautions Integer

Purse

Entry List

race purse Decimal Practice Leaderboard Qualifying Leaderboard Race Leaderboard Starting Grid

Scheduled Start Date/Time

Entry List

race scheduled DateTime

Practice Leaderboard Qualifying Leaderboard Race Leaderboard Schedule Starting Grid Note: Please see the FAQ section for more information.

Stage Count Race Leaderboard race stage_count Integer

Status

Entry List

race status String

Practice Leaderboard Qualifying Leaderboard Race Leaderboard Schedule Starting Grid Note: Please see the FAQ section for more information.

Updated 08.29.17


Track Information


Address Schedule track address String Tracks

Back stretch

Entry List

track backstretch Integer

Practice Leaderboard Qualifying Leaderboard Race Leaderboard Schedule Starting Grid Tracks

Banking

Entry List

track banking String


City Schedule track city String Tracks

Completion Year Schedule track completed Integer Tracks

Country Schedule track country String Tracks

Distance

Entry List

track distance decimal


Front stretch

Entry List

track frontstretch Integer


Id

Daily Change Log track

id GUID

Driver Statistics record Entry List

track


Market Schedule track market String Tracks

Name

Daily Change Log track

name String Driver Statistics record Entry List

track Practice Leaderboard Qualifying Leaderboard

Updated 08.29.17


Race Leaderboard Schedule Starting Grid Tracks

Owner Schedule track owner String Tracks

Seating

Entry List

track seating Integer


Shape

Entry List

track shape String


State Schedule track state String Tracks

Surface Schedule track surface String Tracks

Type Driver Statistics record

track_type String Schedule track Tracks

Zip Code Schedule track zip Sring Tracks

Updated 08.29.17


Car Information


Car Id

Daily Change Log

car id GUID

Drivers Entry List Qualifying Leaderboard Race Leaderboard Starting Grid

Crew Chief

Drivers

car crew_chief String Entry List Qualifying Leaderboard Race Leaderboard Starting Grid

Engine Id Drivers engine id GUID Engine Name Drivers engine name String In Chase Flag Owner Standings car in_chase Boolean

Manufacturer Id

Daily Change Log

manufacturer id GUID

Drivers Entry List Manufacturer Standings Qualifying Leaderboard Race Leaderboard Starting Grid

Manufacturer Name

Daily Change Log

manufacturer name String

Drivers Entry List Manufacturer Standings Qualifying Leaderboard Race Leaderboard Starting Grid

Number

Daily Change Log

car number Integer

Drivers Entry List Owner Standings Qualifying Leaderboard Race Leaderboard Starting Grid

Owner Id

Drivers

owner id GUID

Entry List Owner Standings Qualifying Leaderboard Race Leaderboard Starting Grid

Owner Name

Drivers

owner name String

Entry List Owner Standings Qualifying Leaderboard Race Leaderboard Starting Grid

Sponsors

Drivers

car sponsors String Entry List Owner Standings Qualifying Leaderboard Race Leaderboard

Updated 08.29.17


Starting Grid

Status Drivers car status String Owner Standings

Updated 08.29.17


Driver Information


Birth Place Drivers driver birth_place String Children Drivers driver children String College Drivers driver college String Country Drivers driver country String Date of Birth Drivers driver birthday Date

First Name

Driver Standings

driver first_name String

Drivers Entry List Practice Leaderboard Qualifying Leaderboard Race Leaderboard Rookie Standings Starting Grid

Full Name

Daily Change Log

driver full_name String

Driver Standings Drivers Entry List Practice Leaderboard Qualifying Leaderboard Race Leaderboard Rookie Standings Starting Grid

Gender Drivers driver gender String Height Drivers driver height Integer Hobbies Drivers driver hobbies String

Id

Daily Change Log

driver id GUID

Driver Standings Drivers Entry List Practice Leaderboard Qualifying Leaderboard Race Leaderboard Rookie Standings Starting Grid

In Chase Flag Driver Standings driver in_chase Boolean Rookie Standings

Last Name

Driver Standings

driver last_name String

Drivers Entry List Practice Leaderboard Qualifying Leaderboard Race Leaderboard Rookie Standings Starting Grid

Points Eligible

Drivers

driver points_eligible Boolean

Entry List Practice Leaderboard Qualifying Leaderboard Race Leaderboard Starting Grid

Residence Drivers driver residence String Rookie Year Drivers driver rookie_year Integer

Updated 08.29.17


Status Driver Standings

driver status String Drivers Rookie Standings

Twitter Handle Drivers driver twitter String Weight Drivers driver weight Decimal

Updated 08.29.17


Team Information


Owner Id

Drivers

owner id GUID Entry List Qualifying Leaderboard Race Leaderboard Starting Grid

Owner Name

Drivers

owner name String Entry List Qualifying Leaderboard Race Leaderboard Starting Grid

Team Id

Drivers

team id GUID Entry List Qualifying Leaderboard Race Leaderboard Starting Grid

Team Name

Drivers

team name String Entry List Qualifying Leaderboard Race Leaderboard Starting Grid

Updated 08.29.17


Practice Statistics


Lap Time Practice Leaderboard result lap_time Decimal Laps Completed Practice Leaderboard result laps_completed Integer Position Practice Leaderboard result position Integer Practice End Time Practice Leaderboard practice end_time Date/Time Practice Sequence Practice Leaderboard practice sequence Integer Practice Start Time Practice Leaderboard practice start_time Date/Time Speed Practice Leaderboard result speed Decimal

Status Practice Leaderboard result status String Note: Please see the FAQ section for more information.

Updated 08.29.17


Qualifying Statistics


Best Lap Time Qualifying Leaderboard entry lap_time Decimal Starting Grid

Best Position Qualifying Leaderboard entry position Integer Starting Grid

Best Speed Qualifying Leaderboard entry speed Decimal Starting Grid Qualifying End Time Qualifying Leaderboard qualifying end_time Date/Time Qualifying Start Time Qualifying Leaderboard qualifying start_time Date/Time Round – Lap Time Qualifying Leaderboard round lap_time Decimal Round – Laps Completed Qualifying Leaderboard round laps_completed Integer Round – Position Qualifying Leaderboard round position Integer Round – Round Number Qualifying Leaderboard round sequence Integer Round – Speed Qualifying Leaderboard round speed Decimal

Status Qualifying Leaderboard entry status String Starting Grid Note: Please see the FAQ section for more information.

Updated 08.29.17


Race Statistics


Average Position Race Leaderboard result avg_position Decimal Average Restart Speed Race Leaderboard result avg_restart_speed Decimal Average Speed Race Leaderboard result avg_speed Decimal Behind Leader Race Leaderboard result behind_leader Decimal Best Lap Race Leaderboard result best_lap Integer Best Lap Speed Race Leaderboard result best_lap_speed Decimal Best Lap Time Race Leaderboard result best_lap_time Decimal Bonus Points Race Leaderboard result bonus_points Integer Driver Rating Race Leaderboard result driver_rating Decimal Elapsed Time Race Leaderboard result elapsed_time Decimal Fastest Laps Race Leaderboard result fastest_laps Integer Laps Behind Race Leaderboard result laps_behind Integer Laps Completed Race Leaderboard result laps_completed Integer

Laps Led Race Leaderboard result laps_led Integer Note: This will not be available until the race has gone to a complete status.

Laps Led – Sequence Race Leaderboard lead sequence Integer Laps Led – Start Lap Race Leaderboard lead start_lap Integer Last Lap Speed Race Leaderboard result last_lap_speed Decimal Last Lap Time Race Leaderboard result last_lap_time Decimal

Money Earned Race Leaderboard result money Decimal Note: This is no longer supported in 2016 or 2017.

Passes Made Race Leaderboard results passes_made Integer Passing Differential Race Leaderboard results passing_differential Integer Penalty Points Race Leaderboard result penalty_points Integer Pit Stops Race Leaderboard result pit_stops Integer Pit Stops – In Time Race Leaderboard pit_stops in_time Decimal Pit Stops – Lap Race Leaderboard pit_stops lap Integer Pit Stops – Leader Lap Race Leaderboard pit_stops leader_lap Integer Pit Stops – Out Time Race Leaderboard pit_stops out_time Decimal Pit Stops – Positions Gained Race Leaderboard pit_stops positions_gained Integer Pit Stops – Sequence Race Leaderboard pit_stops sequence Integer Points Race Leaderboard result points Integer Position Race Leaderboard result position Integer Quality Passes Race Leaderboard result quality_passes Integer Stage 1 Points Race Leaderboard result stage_1_points Integer Stage 1 Win Race Leaderboard result stage_1_win Boolean Stage 2 Points Race Leaderboard result stage_2_points Integer Stage 2 Win Race Leaderboard result stage_2_win Boolean Stage 3 Points Race Leaderboard result stage_3_points Integer Stage 3 Win Race Leaderboard result stage_3_win Boolean Starting Position Race Leaderboard result start_position Integer

Status Race Leaderboard result status String Note: Please see the FAQ section for more information.

Times Led Race Leaderboard result times_led Integer Note: This will not be available until the race has gone to a complete status.

Times Passed Race Leaderboard result times_passed Integer

Updated 08.29.17


Season Statistics


Average Finish Position Driver Statistics record avg_finish_position Decimal Average Start Position Driver Statistics record avg_start_position Decimal Did Not Finish Driver Statistics record dnf Integer Laps Completed Driver Statistics record laps_completed Integer Laps Led Driver Statistics record laps_led Integer Lead Lap Finishes Driver Statistics record lead_lap_finish Integer Miles Completed Driver Statistics record miles_completed Integer

Money Earned Driver Statistics record money Decimal Note: This is no longer supported in 2016 and 2017.

Poles Driver Statistics record poles Integer Running At Finish Driver Statistics record running_at_finish Integer Top 10 Finishes Driver Statistics record top_10 Integer Top 5 Finishes Driver Statistics record top_5 Integer Total Races Driver Statistics record starts Integer Wins Driver Statistics record wins Integer

Updated 08.29.17


Driver Standings


Average Finish Position Driver Standings driver avg_finish_position Decimal Rookie Standings

Average Laps Completed Driver Standings driver avg_laps_completed Decimal Rookie Standings

Average Start Position Driver Standings driver avg_start_position Decimal Rookie Standings

Chase Bonus Driver Standings driver chase_bonus Integer Rookie Standings

Did Not Finish Driver Standings driver dnf Integer Rookie Standings

Laps Led Driver Standings driver laps_led Integer Rookie Standings

Laps Led Percentage Driver Standings driver laps_led_pct Integer Rookie Standings

Money Earned Driver Standings driver money Decimal Rookie Standings Note: This is no longer supported in 2016 and 2017.

Points Driver Standings driver points Integer Rookie Standings

Points Behind Leader Driver Standings driver behind Integer Rookie Standings

Poles Driver Standings driver poles Integer Rookie Standings

Rank Driver Standings driver rank Integer Rookie Standings

Stage Wins Driver Standings driver stage_wins Integer Rookie Standings

Starts Driver Standings driver starts Integer Rookie Standings

Top 10 Finishes Driver Standings driver top_10 Integer Rookie Standings




Total Laps Completed Driver Standings driver laps_completed Integer Rookie Standings

Wins Driver Standings driver wins Integer Rookie Standings

Updated 08.29.17


Rookie Standings


Average Finish Position Driver Standings driver avg_finish_position Decimal Rookie Standings

Average Laps Completed Driver Standings driver avg_laps_completed Decimal Rookie Standings

Average Start Position Driver Standings driver avg_start_position Decimal Rookie Standings

Chase Bonus Driver Standings driver chase_bonus Integer Rookie Standings

Did Not Finish Driver Standings driver dnf Integer Rookie Standings

Laps Led Driver Standings driver laps_led Integer Rookie Standings

Laps Led Percentage Driver Standings driver laps_led_pct Integer Rookie Standings

Money Earned Driver Standings driver money Decimal Rookie Standings Note: This is no longer supported in 2016 and 2017.

Points Driver Standings driver points Integer Rookie Standings

Points Behind Leader Driver Standings driver behind Integer Rookie Standings

Poles Driver Standings driver poles Integer Rookie Standings

Rank Driver Standings driver rank Integer Rookie Standings

Stage Wins Driver Standings driver stage_wins Integer Rookie Standings

Starts Driver Standings driver starts Integer Rookie Standings





Total Laps Completed Driver Standings driver laps_completed Integer Rookie Standings

Wins Driver Standings driver wins Integer Rookie Standings

Updated 08.29.17


Manufacturer Standings


Points Manufacturer Standings manufacturer points Integer Points Behind Leader Manufacturer Standings manufacturer behind Integer Rank Manufacturer Standings manufacturer rank Integer Wins Manufacturer Standings manufacturer wins Integer

Updated 08.29.17


Owner Standings


Did Not Finish Owner Standings car dnf Integer Chase Bonus Owner Standings car chase_bonus Integer Points Owner Standings car points Integer Points Behind Leader Owner Standings car behind Integer Rank Owner Standings car rank Integer Stage Wins Owner Standings car stage_wins Integer Starts Owner Standings car starts Integer Top 10 Finishes Owner Standings car top_10 Integer Top 15 Finishes Owner Standings car top_15 Integer Top 20 Finishes Owner Standings car top_20 Integer Top 5 Finishes Owner Standings car top_5 Integer Wins Owner Standings car wins Integer

Updated 08.29.17


Frequently Asked Questions

Q: What are the race statuses I can expect to see in the feeds and their definitions?

A: Here are the race statuses and their descriptions:

scheduled – The race is scheduled to occur. initialized – We are ready to begin recording actions against the scheduled race. practice – We are currently in the practice round. qualifying – We are currently in the qualifying round. prerace – The qualifying round is over, the main race has not begun. inprogress – The race is in progress. complete – The race is over, we are in the process of validating the race statistics. closed – The race is over and the statistics have been validated. delayed – The race has been delayed. canceled – The race has been canceled. rescheduled – The race has been rescheduled. maintenance – The closed race has been reopened to correct one or more statistics. warmup – The scheduled race is set to take place and will begin soon.

Q: What are the race conditions I can expect to see in the feeds and their definitions? A: Here are the race conditions and their descriptions:

normal – The race is under normal racing conditions. accident_caution – The race is under caution due to an accident. conditions_caution – The race is under caution due to track conditions. weather_caution – The race is under caution due to weather conditions. accident_suspended – The race has been suspended due to an accident. conditions_suspended – The race has been suspended due to track conditions. weather_suspended – The race has been suspended due to weather conditions accident_shortened – The race has been shortened due to an accident. conditions_shortened – The race has been shortened due to track conditions. weather_shortened –The race has been shortened due to weather conditions. pitstops – The race is in progress, but all cars are in the pits.

Q: What are the possible driver statuses for the practice, qualifying, and race session that I can

expect to see in the feeds and their definitions? A: We have 2 different sets of driver statuses: statuses that are used during the session and statuses used

post session.

Here are the live race driver statuses and their descriptions:

ontrack – The driver is currently active in the session. garage – The driver is currently in the garage. accident – The driver is currently off the track, or ended his/her session due to an accident. Here are the post race driver statuses and their descriptions: garage – The driver ended the session in the garage for an unknown reason. running – The driver ended the session running. engine – The driver ended the session due to engine issues.

Updated 08.29.17


vibration – The driver ended the session due to vibration issues. brakes – The driver ended the session due to a brake issue. fuelpump – The driver ended the session due to issue with the fuel pump. spindle – The driver ended the session due to an issues with the spindle. transmission – The driver ended the session due to a transmission issue. handling – The driver ended the session due to handling issues. ignition – The driver ended the session due to an ignition issue. oilleak – The driver ended the session due to an oil leak. overheating – The driver ended the session due to an overheating issue. electrical – The driver ended the session due to an electrical issue. axle – The driver ended the session due to an issue with an axle. clutch – The driver ended the session due to an issue with the clutch. suspension - The driver ended the session due to suspension issues. reargear – The driver ended the session due to rear gear issues. dnq – The driver did not qualify for the race. withdrew – The driver has withdrawn.

Q: What are the flag states I can expect to see in the feeds and their definitions? A: Here are the flag states:

warmup green yellow red finish

Q: What time zone are the date time fields presented in? A: All of our DateTime attributes are in UTC, presented in the ISO 8601 standard format.

ex: 2013-04-03T18:15:00+00:00

For more information: https://en.wikipedia.org/wiki/ISO_8601

Q: Why is the Qualifying Leaderboard empty for the Camping World race at Eldora? A: For the Camping World Truck race at Eldora, the qualifying feed will be empty, as qualifying is handled

differently at that track. The starting grid will not be finalized until 15 minutes prior to the scheduled race start and will be available in the Starting Grid feed.

Updated 08.29.17


Document Change History

Date Section Change

08/29/2017 FAQ Added information regarding the Camping World Truck race at Eldora. 05/22/2017 Race Leaderboard Added data points for stage_3_points, stage_3_wins, and stage_count. 02/27/2017 Race Statistics Corrected the element label for stage_1_win and stage_2_win.

02/22/2017 Race Leaderboard

Added documentation for elapsed_time and fastest_lap in the results element. Added data points for avg_restart_speed, last_lap_speed, and last_lap_time to the results element. Added data points for in_time and out_time to the pit_stops element.

02/15/2017

All Initial release for 2017 season. Race Leaderboards Added stage 1 and 2 points and wins. Driver Standings

Added Chase Bonus and Stage Wins to drivers, rookies, and owners Standings. Owner Standings Rookie Standings

01/10/2017 Documentation Update Updated the NASCAR brand logo for 2017. 08/29/2016 Documentation Update Added Flag States to the FAQ.

08/24/2016

Race Statistics Added Behind Leader, Best Lap, Best Lap Time, and Best Line Speed datapoints. Qualifying Statistics Added Qualifying Start and End time.

Practice Statistics Updated documentation to reflect Practice Start and End times. Data was previously available.

02/22/2016

Race Statistics

Added not regarding earnings information no longer being supported in 2016 Season Statistics Driver Standings Rookie Standings

02/05/2016 Frequently Asked Questions Updated list of possible race statuses 01/27/2016 Initial release for 2016 calendar year

2017 sportradar official nascar statistics feeds...official nascar statistics feeds 2017 season...

Documents