Accuracy Reporting
The following describes how to retrieve event and player accuracy reports for past games.
Event statistics are not considered final until they are validated by our third party statistics sources. Box scores can be considered validated approximately 30 mins after the end of the game when the event status changes from complete
to closed
.
Using the REST API to query for Accuracy Reports
Method | Description | Availability |
---|---|---|
GET | /sports-data/{sport}/v2/reports/leagues/{league_uuid}/events/accuracy | All Leagues |
GET | /sports-data/{sport}/v2/reports/events/{event_uuid}/comparisons | All Leagues |
GET | /sports-data/{sport}/v2/reports/players/{player_uuid}/events/{event_uuid}/comparisons | All Leagues |
League Overall Accuracies
The following query retrieve the calculated accuracy and summary for all the league event predictions in the given date range.
/sports-data/{sport}/v2/reports/events/{event_uuid}/comparisons
The default range is the current season ann only completed events are included.
Here is a partial example of the output's attributes:
"attributes": {
"dateStart": "2022-01-01T05:00:00+00:00",
"dateEnd": "2022-03-01T05:00:00+00:00",
"played": 387,
"wl_correct": 243,
"spread_correct": 192,
"ou_over": 220,
"ou_under": 162,
"ou_even": 5,
"wl_accuracy": 62.79,
"spread_accuracy": 49.61
}
Date ranges for included games can be altered using the startDate
and endDate
query parameters such as:
?startDate=2022-04-21&endDate=2022-04-30
An Event Comparison
The event comparisons
contains a json object listing the home
and away
details for the selected game.
Here's an example:
{
"data": {
"id": "\/american-football\/v2\/reports\/events\/3d628032-c004-5fad-a31d-d4aa257ad6d8\/comparisons",
"type": "EventComparison",
"attributes": {
"uuid": "3d628032-c004-5fad-a31d-d4aa257ad6d8",
"comparisons": {
"home": {
"predicted": {
"winloss": 48.72,
"spread": 0.5,
"overunder": 38.37
},
"actual": {
"winloss": "loss",
"overunder": 32,
"score": 20
},
"market": {
"avgSpread": 2.57,
"avgOverunder": 39.05
}
},
"away": {
"predicted": {
"winloss": 51.28,
"spread": -0.5,
"overunder": 38.37
},
"actual": {
"winloss": "win",
"overunder": 24,
"score": 12
},
"market": {
"avgSpread": -2.57,
"avgOverunder": 39.05
}
}
}
},
"relationships": {
"league": {
"data": {
"type": "League",
"id": "\/american-football\/v2\/leagues\/38344248-9889-11eb-a8ab-0647cdb505d0"
}
},
"event": {
"data": {
"type": "Event",
"id": "\/american-football\/v2\/events\/321167b4-ac35-4d9e-8651-9e8ee309fbd6"
}
},
"winLoss": {
"data": {
"type": "WinLoss",
"id": "\/american-football\/v2\/win_losses\/321167b4-ac35-4d9e-8651-9e8ee309fbd6"
}
},
"winner": {
"data": {
"type": "Team",
"id": "\/american-football\/v2\/teams\/50940e9d-17d3-4fb9-9690-f77a7bf0babd"
}
},
"loser": {
"data": {
"type": "Team",
"id": "\/american-football\/v2\/teams\/df89e1cd-9572-4c1f-9067-793553b5a83f"
}
},
"predictedWinner": {
"data": {
"type": "Team",
"id": "\/american-football\/v2\/teams\/df89e1cd-9572-4c1f-9067-793553b5a83f"
}
},
"predictedLoser": {
"data": {
"type": "Team",
"id": "\/american-football\/v2\/teams\/50940e9d-17d3-4fb9-9690-f77a7bf0babd"
}
}
}
}
}
A Player in an Event Comparisons
This example retrieves the Player's Performance Prediction Comparison Report for a given event.
/sports-data/{sport}/v2/reports/players/{player_uuid}/events/{event_uuid}/comparisons
The result contains a json object listing each predicted
prop along with the actual
result from the box score and in some cases the average market over/under when available. The actual comparison values will vary by player positions.
Here's an example of the comparisons
in the response attributes
for a Quarterback:
The properties available in the result will vary by sport. The following is an example from American Football, but hte same process applies to other sports and leagues.
"comparisons": {
"passingAttempts": {
"actual": 41,
"predicted": 37.951,
"marketAvgOver": "1.83",
"marketAvgUnder": "1.91"
},
"passingCompletions": {
"actual": 29,
"predicted": 26.8912,
"marketAvgOver": "2.05",
"marketAvgUnder": "1.72"
},
"passingCmpPct": {
"actual": 70.732,
"predicted": 70.8579
},
"passingYards": {
"actual": 240,
"predicted": 304.203,
"marketAvgOver": "1.83",
"marketAvgUnder": "1.91"
},
"passingSacks": {
"actual": 7,
"predicted": 3.05492
},
"passingSackYards": {
"actual": 49,
"predicted": 24.3694
},
"passingTouchdowns": {
"actual": 1,
"predicted": 2.21337,
"marketAvgOver": "1.57",
"marketAvgUnder": "2.30"
},
"passingLongest": {
"actual": 28,
"predicted": 45.3328,
"marketAvgOver": "1.83",
"marketAvgUnder": "1.91"
},
"rushingAvgYards": {
"actual": 2,
"predicted": 2.72214
},
"rushingAttempts": {
"actual": 1,
"predicted": 1.40965
},
"rushingTouchdowns": {
"actual": 0,
"predicted": 0.0568368
},
"rushingYards": {
"actual": 2,
"predicted": 3.83727,
"marketAvgOver": "1.92",
"marketAvgUnder": "1.81"
},
"rushingLongest": {
"actual": 2,
"predicted": 2.63935
},
"passingInterceptions": {
"actual": 3,
"predicted": 1.06157,
"marketAvgOver": "1.78",
"marketAvgUnder": "1.95"
},
"fumblesFumbles": {
"actual": 1,
"predicted": 0.83
}
}
Other Reports
Additional static reporting documents may be available. If you are looking for something specific please contact your account representative with additional requests.