Leaders¶
griddy / nfl / endpoints / ngs / leaders**
leaders
¶
NGS Leaders endpoints for top plays and leaderboards.
Classes¶
NgsLeaders
¶
Bases: NgsBaseSDK
flowchart TD
griddy.nfl.endpoints.ngs.leaders.NgsLeaders[NgsLeaders]
griddy.nfl.endpoints.ngs.NgsBaseSDK[NgsBaseSDK]
griddy.nfl.basesdk.BaseSDK[BaseSDK]
griddy.nfl.endpoints.ngs.NgsBaseSDK --> griddy.nfl.endpoints.ngs.leaders.NgsLeaders
griddy.nfl.basesdk.BaseSDK --> griddy.nfl.endpoints.ngs.NgsBaseSDK
click griddy.nfl.endpoints.ngs.leaders.NgsLeaders href "" "griddy.nfl.endpoints.ngs.leaders.NgsLeaders"
click griddy.nfl.endpoints.ngs.NgsBaseSDK href "" "griddy.nfl.endpoints.ngs.NgsBaseSDK"
click griddy.nfl.basesdk.BaseSDK href "" "griddy.nfl.basesdk.BaseSDK"
NGS Leaders endpoints for top plays and leaderboards.
Provides access to: - Fastest ball carriers (max speed) - Fastest sacks (time to sack) - Improbable completions (completion probability) - Incredible YAC (yards after catch over expectation) - Longest plays (in-play distance) - Longest tackles (distance covered to tackle) - Remarkable rushes (rush yards over expected)
Source code in griddy/nfl/basesdk.py
Functions¶
get_fastest_ball_carriers
¶
get_fastest_ball_carriers(
*,
season: int,
season_type: str,
limit: int = 20,
week: Optional[int] = None,
retries: OptionalNullable[RetryConfig] = UNSET,
server_url: Optional[str] = None,
timeout_ms: Optional[int] = None,
http_headers: Optional[Mapping[str, str]] = None
) -> NgsSpeedLeadersResponse
Get fastest ball carrier speeds.
Returns leaderboard of fastest ball carrier speeds recorded.
| PARAMETER | DESCRIPTION |
|---|---|
season
|
Season year (e.g., 2025)
TYPE:
|
season_type
|
Season type (REG, PRE, POST)
TYPE:
|
limit
|
Number of results (default: 20)
TYPE:
|
week
|
Optional week filter
TYPE:
|
Source code in griddy/nfl/endpoints/ngs/leaders.py
get_fastest_ball_carriers_async
async
¶
get_fastest_ball_carriers_async(
*,
season: int,
season_type: str,
limit: int = 20,
week: Optional[int] = None,
retries: OptionalNullable[RetryConfig] = UNSET,
server_url: Optional[str] = None,
timeout_ms: Optional[int] = None,
http_headers: Optional[Mapping[str, str]] = None
) -> NgsSpeedLeadersResponse
Get fastest ball carrier speeds (async).
Source code in griddy/nfl/endpoints/ngs/leaders.py
get_fastest_sacks
¶
get_fastest_sacks(
*,
season: int,
season_type: str,
limit: int = 20,
week: Optional[int] = None,
retries: OptionalNullable[RetryConfig] = UNSET,
server_url: Optional[str] = None,
timeout_ms: Optional[int] = None,
http_headers: Optional[Mapping[str, str]] = None
) -> NgsSackLeadersResponse
Get fastest sack times.
Returns leaderboard of quickest sacks by time to tackle.
| PARAMETER | DESCRIPTION |
|---|---|
season
|
Season year (e.g., 2025)
TYPE:
|
season_type
|
Season type (REG, PRE, POST)
TYPE:
|
limit
|
Number of results (default: 20)
TYPE:
|
week
|
Optional week filter
TYPE:
|
Source code in griddy/nfl/endpoints/ngs/leaders.py
get_fastest_sacks_async
async
¶
get_fastest_sacks_async(
*,
season: int,
season_type: str,
limit: int = 20,
week: Optional[int] = None,
retries: OptionalNullable[RetryConfig] = UNSET,
server_url: Optional[str] = None,
timeout_ms: Optional[int] = None,
http_headers: Optional[Mapping[str, str]] = None
) -> NgsSackLeadersResponse
Get fastest sack times (async).
Source code in griddy/nfl/endpoints/ngs/leaders.py
get_improbable_completions
¶
get_improbable_completions(
*,
season: int,
season_type: str,
retries: OptionalNullable[RetryConfig] = UNSET,
server_url: Optional[str] = None,
timeout_ms: Optional[int] = None,
http_headers: Optional[Mapping[str, str]] = None
) -> NgsCompletionLeadersResponse
Get most improbable completions.
Returns leaderboard of completions with lowest completion probability.
| PARAMETER | DESCRIPTION |
|---|---|
season
|
Season year (e.g., 2025)
TYPE:
|
season_type
|
Season type (REG, PRE, POST)
TYPE:
|
Source code in griddy/nfl/endpoints/ngs/leaders.py
get_improbable_completions_async
async
¶
get_improbable_completions_async(
*,
season: int,
season_type: str,
retries: OptionalNullable[RetryConfig] = UNSET,
server_url: Optional[str] = None,
timeout_ms: Optional[int] = None,
http_headers: Optional[Mapping[str, str]] = None
) -> NgsCompletionLeadersResponse
Get most improbable completions (async).
Source code in griddy/nfl/endpoints/ngs/leaders.py
get_incredible_yac
¶
get_incredible_yac(
*,
season: int,
season_type: str,
retries: OptionalNullable[RetryConfig] = UNSET,
server_url: Optional[str] = None,
timeout_ms: Optional[int] = None,
http_headers: Optional[Mapping[str, str]] = None
) -> NgsYACLeadersResponse
Get incredible YAC plays.
Returns leaderboard of yards after catch over expectation.
| PARAMETER | DESCRIPTION |
|---|---|
season
|
Season year (e.g., 2025)
TYPE:
|
season_type
|
Season type (REG, PRE, POST)
TYPE:
|
Source code in griddy/nfl/endpoints/ngs/leaders.py
get_incredible_yac_async
async
¶
get_incredible_yac_async(
*,
season: int,
season_type: str,
retries: OptionalNullable[RetryConfig] = UNSET,
server_url: Optional[str] = None,
timeout_ms: Optional[int] = None,
http_headers: Optional[Mapping[str, str]] = None
) -> NgsYACLeadersResponse
Get incredible YAC plays (async).
Source code in griddy/nfl/endpoints/ngs/leaders.py
get_longest_plays
¶
get_longest_plays(
*,
season: int,
season_type: str,
limit: int = 20,
week: Optional[int] = None,
retries: OptionalNullable[RetryConfig] = UNSET,
server_url: Optional[str] = None,
timeout_ms: Optional[int] = None,
http_headers: Optional[Mapping[str, str]] = None
) -> NgsDistanceLeadersResponse
Get longest plays by in-play distance.
Returns leaderboard of plays with most distance covered.
| PARAMETER | DESCRIPTION |
|---|---|
season
|
Season year (e.g., 2025)
TYPE:
|
season_type
|
Season type (REG, PRE, POST)
TYPE:
|
limit
|
Number of results (default: 20)
TYPE:
|
week
|
Optional week filter
TYPE:
|
Source code in griddy/nfl/endpoints/ngs/leaders.py
get_longest_plays_async
async
¶
get_longest_plays_async(
*,
season: int,
season_type: str,
limit: int = 20,
week: Optional[int] = None,
retries: OptionalNullable[RetryConfig] = UNSET,
server_url: Optional[str] = None,
timeout_ms: Optional[int] = None,
http_headers: Optional[Mapping[str, str]] = None
) -> NgsDistanceLeadersResponse
Get longest plays by in-play distance (async).
Source code in griddy/nfl/endpoints/ngs/leaders.py
get_longest_tackles
¶
get_longest_tackles(
*,
season: int,
season_type: str,
limit: int = 20,
week: Optional[int] = None,
retries: OptionalNullable[RetryConfig] = UNSET,
server_url: Optional[str] = None,
timeout_ms: Optional[int] = None,
http_headers: Optional[Mapping[str, str]] = None
) -> NgsTackleLeadersResponse
Get longest tackles by distance covered.
Returns leaderboard of tackles with most distance covered to make the tackle.
| PARAMETER | DESCRIPTION |
|---|---|
season
|
Season year (e.g., 2025)
TYPE:
|
season_type
|
Season type (REG, PRE, POST)
TYPE:
|
limit
|
Number of results (default: 20)
TYPE:
|
week
|
Optional week filter
TYPE:
|
Source code in griddy/nfl/endpoints/ngs/leaders.py
get_longest_tackles_async
async
¶
get_longest_tackles_async(
*,
season: int,
season_type: str,
limit: int = 20,
week: Optional[int] = None,
retries: OptionalNullable[RetryConfig] = UNSET,
server_url: Optional[str] = None,
timeout_ms: Optional[int] = None,
http_headers: Optional[Mapping[str, str]] = None
) -> NgsTackleLeadersResponse
Get longest tackles by distance covered (async).
Source code in griddy/nfl/endpoints/ngs/leaders.py
get_remarkable_rushes
¶
get_remarkable_rushes(
*,
season: int,
season_type: str,
retries: OptionalNullable[RetryConfig] = UNSET,
server_url: Optional[str] = None,
timeout_ms: Optional[int] = None,
http_headers: Optional[Mapping[str, str]] = None
) -> NgsERYLeadersResponse
Get remarkable rushes.
Returns leaderboard of rush yards over expected (ERY).
| PARAMETER | DESCRIPTION |
|---|---|
season
|
Season year (e.g., 2025)
TYPE:
|
season_type
|
Season type (REG, PRE, POST)
TYPE:
|
Source code in griddy/nfl/endpoints/ngs/leaders.py
get_remarkable_rushes_async
async
¶
get_remarkable_rushes_async(
*,
season: int,
season_type: str,
retries: OptionalNullable[RetryConfig] = UNSET,
server_url: Optional[str] = None,
timeout_ms: Optional[int] = None,
http_headers: Optional[Mapping[str, str]] = None
) -> NgsERYLeadersResponse
Get remarkable rushes (async).