📊 aggregate statistics

Player Aggregate Stats Object

{
    "event": {
        "id": "EVNT_47c18807ebc0429e8dd0335203a62373",
        "sportsdataioId": "19039",
        "sportradarId": "56779053-89da-4939-bc22-9669ae1fe05a",
        "oddsjamId": "11434-17233-25-35",
        "theOddsApiId": "f1bc532dff946d15cb85654b5c4b246e",
        "sport": "Football",
        "league": "NFL",
        "name": "Dallas Cowboys @ Philadelphia Eagles",
        "nameSpecial": null,
        "startTime": "2025-09-05T00:20:00Z",
        "startDate": "2025-09-05",
        "seasonType": "REG",
        "sportId": "SPRT_americanfootball",
        "leagueId": "LGUE_nfl",
        "contestantAway": {
            "id": "TEAM_a63ec49ed87c4be6909fe5cc016a82be",
            "fullName": "Dallas Cowboys",
            "abbr": "DAL",
            "aggregateStats": {
                "season": "2024",
                "stats": {
                    "general": {
                        "week": 18,
                        "record": "7-10",
                        "total_dvoa": {
                            "rank": 24,
                            "value": "-11.6%"
                        },
                        "point_differential": {
                            "rank": 26,
                            "value": -118.0,
                            "rank_type": "high_to_low"
                        },
                        "strength_of_schedule": {
                            "past": {
                                "rank": 9,
                                "value": "2.5%"
                            },
                            "upcoming": {
                                "rank": 1,
                                "value": "0.0%"
                            }
                        }
                    },
                    "offensive": {
                        "offense_dvoa": {
                            "rank": 25,
                            "value": "-12.3%"
                        },
                        "counting_stats": {
                            "passing_tds": {
                                "rank": 15,
                                "total": 23,
                                "per_game": 1.35,
                                "rank_type": "high_to_low"
                            },
                            "sacks_taken": {
                                "rank": 14,
                                "total": 38,
                                "per_game": 2.24,
                                "rank_type": "low_to_high"
                            },
                            "pass_attempts": {
                                "rank": 3,
                                "total": 637,
                                "per_game": 37.47,
                                "rank_type": "high_to_low"
                            },
                            "passing_yards": {
                                "rank": 11,
                                "total": 3862,
                                "per_game": 227.18,
                                "rank_type": "high_to_low"
                            },
                            "interceptions_thrown": {
                                "rank": 22,
                                "total": 14,
                                "per_game": 0.82,
                                "rank_type": "low_to_high"
                            }
                        },
                        "efficiency_stats": {
                            "interception_rate": {
                                "rank": 13,
                                "value": 2.2,
                                "rank_type": "low_to_high"
                            },
                            "sack_rate_offense": {
                                "rank": 24,
                                "value": 5.97,
                                "rank_type": "low_to_high"
                            },
                            "touchdown_percentage": {
                                "rank": 31,
                                "value": 2.63,
                                "rank_type": "high_to_low"
                            },
                            "completion_percentage": {
                                "rank": 26,
                                "value": 62.48,
                                "rank_type": "high_to_low"
                            },
                            "yards_per_pass_attempt": {
                                "rank": 27,
                                "value": 6.42,
                                "rank_type": "high_to_low"
                            }
                        }
                    }
                }
            }
        },
        "contestantHome": {
            "id": "TEAM_7ab6eb241f3e440ab8c6d771fb0694a9",
            "fullName": "Philadelphia Eagles",
            "abbr": "PHI",
            "aggregateStats": {
                "season": "2024",
                "stats": {
                    "general": {
                        "week": 18,
                        "record": "14-3",
                        "total_dvoa": {
                            "rank": 5,
                            "value": "21.3%"
                        },
                        "point_differential": {
                            "rank": 2,
                            "value": 160.0,
                            "rank_type": "high_to_low"
                        },
                        "strength_of_schedule": {
                            "past": {
                                "rank": 29,
                                "value": "-3.5%"
                            },
                            "upcoming": {
                                "rank": 1,
                                "value": "0.0%"
                            }
                        }
                    },
                    "defensive": {
                        "defense_dvoa": {
                            "rank": 1,
                            "value": "-16.2%"
                        },
                        "counting_stats": {
                            "sacks": {
                                "rank": 14,
                                "total": 41,
                                "per_game": 2.41,
                                "rank_type": "high_to_low"
                            },
                            "qb_hits": {
                                "rank": 22,
                                "total": 41,
                                "per_game": 2.41,
                                "rank_type": "high_to_low"
                            },
                            "qb_pressures": {
                                "rank": 27,
                                "total": 118,
                                "per_game": 6.94,
                                "rank_type": "high_to_low"
                            },
                            "passing_tds_allowed": {
                                "rank": 8,
                                "total": 22,
                                "per_game": 1.29,
                                "rank_type": "low_to_high"
                            },
                            "pass_attempts_allowed": {
                                "rank": 12,
                                "total": 542,
                                "per_game": 31.88,
                                "rank_type": "low_to_high"
                            },
                            "passing_yards_allowed": {
                                "rank": 1,
                                "total": 2961,
                                "per_game": 174.18,
                                "rank_type": "low_to_high"
                            }
                        },
                        "efficiency_stats": {
                            "sack_rate": {
                                "rank": 14,
                                "value": 7.56,
                                "rank_type": "high_to_low"
                            },
                            "qb_hit_rate": {
                                "rank": 21,
                                "value": 7.56,
                                "rank_type": "high_to_low"
                            },
                            "qb_pressure_rate": {
                                "rank": 27,
                                "value": 21.77,
                                "rank_type": "high_to_low"
                            },
                            "interception_rate_defense": {
                                "rank": 21,
                                "value": 1.85,
                                "rank_type": "high_to_low"
                            },
                            "touchdown_percentage_allowed": {
                                "rank": 3,
                                "value": 3.1,
                                "rank_type": "low_to_high"
                            },
                            "completion_percentage_allowed": {
                                "rank": 6,
                                "value": 62.18,
                                "rank_type": "low_to_high"
                            },
                            "yards_per_pass_attempt_allowed": {
                                "rank": 1,
                                "value": 5.46,
                                "rank_type": "low_to_high"
                            }
                        }
                    }
                }
            }
        },
        "neutralVenue": null
    },
    "team": {
        "id": "TEAM_a63ec49ed87c4be6909fe5cc016a82be",
        "sportsdataioId": "9",
        "oddsjamId": "0BDD5205ECCB",
        "sportradarId": "e627eec7-bbae-4fa4-8e73-8e1d6bc5c060",
        "locale": "Dallas",
        "name": "Cowboys",
        "fullName": "Dallas Cowboys",
        "abbr": "DAL",
        "sportId": "SPRT_americanfootball"
    },
    "opponent": {
        "id": "TEAM_7ab6eb241f3e440ab8c6d771fb0694a9",
        "sportsdataioId": "26",
        "oddsjamId": "EDCC2866B795",
        "sportradarId": "386bdbf9-9eea-4869-bb9a-274b0bc66e80",
        "locale": "Philadelphia",
        "name": "Eagles",
        "fullName": "Philadelphia Eagles",
        "abbr": "PHI",
        "sportId": "SPRT_americanfootball"
    },
    "locationType": "Away",
    "player": {
        "id": "PLYR_e9e9d0e0b70b4143b49b08ba2b16f406",
        "sportsdataioId": "18055",
        "oddsjamId": "4E18B0FEC4C5",
        "sportradarId": "86197778-8d4b-4eba-affe-08ef7be7c70b",
        "firstName": "Dak",
        "lastName": "Prescott",
        "sportId": "SPRT_americanfootball",
        "fullName": "Dak Prescott",
        "aggregateStats": {
            "season": "2024",
            "position": "QB",
            "games_played": 8,
            "stats": {
                "counting_stats": {
                    "sacks": {
                        "total": {
                            "value": 21,
                            "positional_rank": 50
                        },
                        "per_game": {
                            "value": 2.62,
                            "positional_rank": 19
                        },
                        "rank_type": "low_to_high",
                        "rank_total_players": 77
                    },
                    "completions": {
                        "total": {
                            "value": 185,
                            "positional_rank": 30
                        },
                        "redzone": {
                            "total": {
                                "value": 17,
                                "positional_rank": 32
                            },
                            "per_game": {
                                "value": 2.12,
                                "positional_rank": 28
                            }
                        },
                        "inside_5": {
                            "total": {
                                "value": 2,
                                "positional_rank": 42
                            },
                            "per_game": {
                                "value": 0.25,
                                "positional_rank": 38
                            }
                        },
                        "per_game": {
                            "value": 23.12,
                            "positional_rank": 8
                        },
                        "inside_10": {
                            "total": {
                                "value": 4,
                                "positional_rank": 43
                            },
                            "per_game": {
                                "value": 0.5,
                                "positional_rank": 43
                            }
                        },
                        "rank_type": "high_to_low",
                        "rank_total_players": 77
                    },
                    "passing_tds": {
                        "total": {
                            "value": 11,
                            "positional_rank": 31
                        },
                        "redzone": {
                            "total": {
                                "value": 7,
                                "positional_rank": 31
                            },
                            "per_game": {
                                "value": 0.88,
                                "positional_rank": 27
                            }
                        },
                        "inside_5": {
                            "total": {
                                "value": 2,
                                "positional_rank": 39
                            },
                            "per_game": {
                                "value": 0.25,
                                "positional_rank": 36
                            }
                        },
                        "per_game": {
                            "value": 1.38,
                            "positional_rank": 19
                        },
                        "inside_10": {
                            "total": {
                                "value": 3,
                                "positional_rank": 42
                            },
                            "per_game": {
                                "value": 0.38,
                                "positional_rank": 41
                            }
                        },
                        "rank_type": "high_to_low",
                        "rank_total_players": 77
                    },
                    "interceptions": {
                        "total": {
                            "value": 8,
                            "positional_rank": 56
                        },
                        "per_game": {
                            "value": 1.0,
                            "positional_rank": 14
                        },
                        "rank_type": "low_to_high",
                        "rank_total_players": 77
                    },
                    "pass_attempts": {
                        "total": {
                            "value": 286,
                            "positional_rank": 30
                        },
                        "redzone": {
                            "total": {
                                "value": 39,
                                "positional_rank": 30
                            },
                            "per_game": {
                                "value": 4.88,
                                "positional_rank": 17
                            }
                        },
                        "inside_5": {
                            "total": {
                                "value": 5,
                                "positional_rank": 42
                            },
                            "per_game": {
                                "value": 0.62,
                                "positional_rank": 45
                            }
                        },
                        "per_game": {
                            "value": 35.75,
                            "positional_rank": 5
                        },
                        "inside_10": {
                            "total": {
                                "value": 10,
                                "positional_rank": 41
                            },
                            "per_game": {
                                "value": 1.25,
                                "positional_rank": 48
                            }
                        },
                        "rank_type": "high_to_low",
                        "rank_total_players": 77
                    },
                    "passing_yards": {
                        "total": {
                            "value": 1978,
                            "positional_rank": 31
                        },
                        "per_game": {
                            "value": 247.25,
                            "positional_rank": 11
                        },
                        "rank_type": "high_to_low",
                        "rank_total_players": 77
                    },
                    "passing_air_yards": {
                        "total": {
                            "value": 2270,
                            "positional_rank": 30
                        },
                        "per_game": {
                            "value": 283.75,
                            "positional_rank": 3
                        },
                        "rank_type": "high_to_low",
                        "rank_total_players": 77
                    },
                    "passing_yards_after_catch": {
                        "total": {
                            "value": 939,
                            "positional_rank": 29
                        },
                        "per_game": {
                            "value": 117.38,
                            "positional_rank": 13
                        },
                        "rank_type": "high_to_low",
                        "rank_total_players": 77
                    }
                },
                "efficiency_stats": {
                    "passing_epa": {
                        "value": -7.37,
                        "rank_type": "high_to_low",
                        "positional_rank": 51,
                        "rank_total_players": 77
                    },
                    "yards_per_attempt": {
                        "value": 6.92,
                        "rank_type": "high_to_low",
                        "positional_rank": 34,
                        "rank_total_players": 77
                    },
                    "completion_percentage": {
                        "value": 64.69,
                        "redzone": {
                            "value": 43.59,
                            "positional_rank": 43
                        },
                        "inside_5": {
                            "value": 40.0,
                            "positional_rank": 30
                        },
                        "inside_10": {
                            "value": 40.0,
                            "positional_rank": 37
                        },
                        "rank_type": "high_to_low",
                        "positional_rank": 40,
                        "rank_total_players": 77
                    }
                }
            }
        }
    },
    "market": {
        "id": "MKT_66072c73020447638eeed55d0313c0db",
        "name": "Player Prop Total Passing Yards",
        "type": "prop",
        "proposition": "total",
        "player": true,
        "team": false,
        "future": false,
        "oddsjamId": "player_passing_yards",
        "sportradarId": "sr:market:914",
        "sportsdataioId": null,
        "theOddsApiId": "player_pass_yds",
        "sport": {
            "id": "SPRT_americanfootball",
            "name": "Football"
        },
        "league": {
            "id": "LGUE_nfl",
            "name": "National Football League",
            "abbr": "NFL"
        },
        "segment": {
            "id": "SEGM_M",
            "name": "Match"
        },
        "metric": {
            "id": "METR_passyds",
            "name": "Passing Yards"
        }
    },
    "position": "Under",
    "DVP": null,
    "dvpRank": null,
    "dvpAvg": null,
    "dvpPosition": "QB",
    "consensusProjection": 240.46,
    "venue": null,
    "startingPitcher": {
        "id": "",
        "sportsdataioId": "",
        "oddsjamId": "",
        "sportradarId": "",
        "firstName": "",
        "lastName": "",
        "hand": null
    },
    "L1": {
        "hits": 0,
        "hitPerc": 0.0,
        "stdev": 0,
        "mean": 133.0,
        "median": 133
    },
    "L2": {
        "hits": 1,
        "hitPerc": 50.0,
        "stdev": 77.78,
        "mean": 188.0,
        "median": 188.0
    },
    "L3": {
        "hits": 1,
        "hitPerc": 33.33,
        "stdev": 55.3,
        "mean": 184.67,
        "median": 178
    },
    "L4": {
        "hits": 2,
        "hitPerc": 50.0,
        "stdev": 95.07,
        "mean": 226.5,
        "median": 210.5
    },
    "L5": {
        "hits": 2,
        "hitPerc": 40.0,
        "stdev": 82.37,
        "mean": 225.4,
        "median": 221
    },
    "L6": {
        "hits": 3,
        "hitPerc": 50.0,
        "stdev": 96.75,
        "mean": 251.0,
        "median": 232.0
    },
    "L7": {
        "hits": 4,
        "hitPerc": 57.14,
        "stdev": 105.36,
        "mean": 272.71,
        "median": 243
    },
    "L8": {
        "hits": 5,
        "hitPerc": 62.5,
        "stdev": 97.57,
        "mean": 273.5,
        "median": 261.0
    },
    "L9": {
        "hits": 6,
        "hitPerc": 66.67,
        "stdev": 94.33,
        "mean": 281.44,
        "median": 279
    },
    "L10": {
        "hits": 7,
        "hitPerc": 70.0,
        "stdev": 89.39,
        "mean": 278.6,
        "median": 266.0
    },
    "L11": {
        "hits": 7,
        "hitPerc": 63.64,
        "stdev": 95.35,
        "mean": 265.45,
        "median": 253
    },
    "L12": {
        "hits": 8,
        "hitPerc": 66.67,
        "stdev": 90.93,
        "mean": 265.92,
        "median": 262.0
    },
    "L13": {
        "hits": 9,
        "hitPerc": 69.23,
        "stdev": 87.54,
        "mean": 268.46,
        "median": 271
    },
    "L14": {
        "hits": 10,
        "hitPerc": 71.43,
        "stdev": 85.75,
        "mean": 272.93,
        "median": 275.0
    },
    "L15": {
        "hits": 10,
        "hitPerc": 66.67,
        "stdev": 85.43,
        "mean": 267.33,
        "median": 271
    },
    "L16": {
        "hits": 11,
        "hitPerc": 68.75,
        "stdev": 89.32,
        "mean": 275.88,
        "median": 275.0
    },
    "L17": {
        "hits": 12,
        "hitPerc": 70.59,
        "stdev": 89.7,
        "mean": 281.65,
        "median": 279
    },
    "L18": {
        "hits": 13,
        "hitPerc": 72.22,
        "stdev": 87.18,
        "mean": 282.89,
        "median": 289.0
    },
    "L19": {
        "hits": 14,
        "hitPerc": 73.68,
        "stdev": 84.76,
        "mean": 282.32,
        "median": 279
    },
    "L20": {
        "hits": 14,
        "hitPerc": 70.0,
        "stdev": 87.42,
        "mean": 275.85,
        "median": 275.5
    },
    "season": {
        "hits": 3,
        "hitPerc": 50.0,
        "stdev": 96.75,
        "mean": 251,
        "median": 232.0,
        "count": 6
    },
    "vsOpponent": {
        "dataStartDate": "2023-11-05T21:25:00Z",
        "currentSeason": "2024-2025",
        "2023-2024": {
            "hits": 2,
            "hitPerc": 100.0,
            "stdev": 72.83,
            "mean": 322.5,
            "median": 322.5,
            "count": 2
        },
        "all": {
            "hits": 2,
            "hitPerc": 100.0,
            "stdev": 72.83,
            "mean": 322.5,
            "median": 322.5,
            "count": 2
        }
    },
    "atLocationType": {
        "dataStartDate": "2023-09-11T00:20:00Z",
        "currentSeason": "2024-2025",
        "2024-2025": {
            "hits": 2,
            "hitPerc": 50.0,
            "stdev": 90.06,
            "mean": 237.25,
            "median": 232.0,
            "count": 4
        },
        "2023-2024": {
            "hits": 5,
            "hitPerc": 55.56,
            "stdev": 79.15,
            "mean": 227.33,
            "median": 249,
            "count": 9
        },
        "all": {
            "hits": 7,
            "hitPerc": 53.85,
            "stdev": 78.91,
            "mean": 230.38,
            "median": 243,
            "count": 13
        }
    },
    "bestPrice": {
        "id": "PRICE_4224b83af40744ee8f54a505a73f6c28",
        "line": 237.5,
        "odds": -115,
        "ev": null,
        "book": {
            "id": "BOOK_IPBQaQQTCRxplZx7SYOA",
            "name": "Caesars",
            "abbr": "ca"
        }
    }
}

Endpoints

📊 player aggregate stats detail

id (string)

A unique identifier representing the player. Each player ID starts with the unique character set PLYR_.


sportsdataioId (string)

External identifier from SportsData.io API for this player.


oddsjamId (string)

External identifier from OddsJam API for this player.


sportradarId (string)

External identifier from Sportradar API for this player.


firstName (string)

Player's first name.


lastName (string)

Player's last name.


sportId (string)

Sport identifier with format SPRT_* (e.g., "SPRT_americanfootball", "SPRT_basketball").


fullName (string)

Player's complete name (firstName + lastName).


currentTeams (array)

Array of teams the player is currently rostered on.

id (string)

Unique team identifier with format TEAM_*.

fullName (string)

Team's full display name.


seasonStats (object)

Aggregate statistical data for the player's performance in a specific season.

season (string)

The season year for these statistics (e.g., "2024").

position (string)

Player's position during this season (e.g., "QB", "RB", "WR").

gamesplayed (integer)_

Number of games the player participated in during this season.

stats (object)

Container for all statistical categories.

countingstats (object)_

Raw statistical totals and per-game averages. Can be filtered using the metrics query parameter.

[Stat Name] (object)

Each counting statistic includes multiple data points and may have location-specific breakdowns.

total (object)
  • value (number): Total season value for this statistic
  • positional_rank (integer): Player's rank among all players at this position
pergame (object)_
  • value (number): Per-game average for this statistic
  • positional_rank (integer): Player's per-game rank among all players at this position
ranktype (string)_

Indicates ranking direction. Values: "high_to_low" (higher values = better rank) or "low_to_high" (lower values = better rank).

totalposition_players (integer)_

Total number of qualified players at this position used for ranking calculations.

Location-Specific Stats (optional objects)

Some statistics include breakdowns by field location:

  • redzone: Performance in the red zone area
  • inside_5: Performance inside the 5-yard line
  • inside_10: Performance inside the 10-yard line

efficiencystats (object)_

Percentage-based and efficiency metrics. Can be filtered using the metrics query parameter.

[Stat Name] (object)

Each efficiency statistic includes ranking information.

value (number)

The calculated efficiency value (typically a percentage or ratio).

positionalrank (integer)_

Player's rank among all players at this position for this efficiency metric.

ranktype (string)_

Indicates ranking direction for this efficiency metric.

totalposition_players (integer)_

Total number of qualified players at this position used for ranking calculations.

rankFilter (string)

The statistic used to determine qualified players for ranking (e.g., "pass_attempts", "carries").

rankFilterValue (number)

The minimum threshold value required for a player to be included in positional rankings.