Skip to content

Stats

griddy / nfl / endpoints / ngs / stats**

stats

NGS Stats endpoints for player statistics.

Classes

NgsStats 

NgsStats(
    sdk_config: SDKConfiguration,
    parent_ref: Optional[object] = None,
)

Bases: NgsBaseSDK


              flowchart TD
              griddy.nfl.endpoints.ngs.stats.NgsStats[NgsStats]
              griddy.nfl.endpoints.ngs.NgsBaseSDK[NgsBaseSDK]
              griddy.nfl.basesdk.BaseSDK[BaseSDK]

                              griddy.nfl.endpoints.ngs.NgsBaseSDK --> griddy.nfl.endpoints.ngs.stats.NgsStats
                                griddy.nfl.basesdk.BaseSDK --> griddy.nfl.endpoints.ngs.NgsBaseSDK
                



              click griddy.nfl.endpoints.ngs.stats.NgsStats href "" "griddy.nfl.endpoints.ngs.stats.NgsStats"
              click griddy.nfl.endpoints.ngs.NgsBaseSDK href "" "griddy.nfl.endpoints.ngs.NgsBaseSDK"
              click griddy.nfl.basesdk.BaseSDK href "" "griddy.nfl.basesdk.BaseSDK"

NGS Stats endpoints for player statistics.

Provides access to: - Passing statistics (time to throw, air yards, completion probability, etc.) - Receiving statistics (separation, cushion, YAC, etc.) - Rushing statistics (time to LOS, rush yards over expected, etc.)

Source code in griddy/nfl/basesdk.py 
79
80
81
82
83
84
85
def __init__(
    self,
    sdk_config: SDKConfiguration,
    parent_ref: Optional[object] = None,
) -> None:
    self.sdk_configuration = sdk_config
    self.parent_ref = parent_ref
Functions
get_passing_stats 
get_passing_stats(
    *,
    season: int,
    season_type: str,
    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
) -> NgsPassingStatsResponse

Get NGS passing statistics.

Returns detailed passing statistics including time to throw, air yards, completion probability, and more.

PARAMETER DESCRIPTION
season

The season year (e.g., 2025)

TYPE: int

season_type

Season type (REG, PRE, POST)

TYPE: str

week

Optional week filter

TYPE: Optional[int] DEFAULT: None

retries

Override the default retry configuration

TYPE: OptionalNullable[RetryConfig] DEFAULT: UNSET

server_url

Override the default server URL

TYPE: Optional[str] DEFAULT: None

timeout_ms

Override the default timeout

TYPE: Optional[int] DEFAULT: None

http_headers

Additional headers to send

TYPE: Optional[Mapping[str, str]] DEFAULT: None

RETURNS DESCRIPTION
NgsPassingStatsResponse

Dict containing passing statistics
Source code in griddy/nfl/endpoints/ngs/stats.py 
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
def get_passing_stats(
    self,
    *,
    season: int,
    season_type: str,
    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,
) -> models.NgsPassingStatsResponse:
    """Get NGS passing statistics.

    Returns detailed passing statistics including time to throw,
    air yards, completion probability, and more.

    Args:
        season: The season year (e.g., 2025)
        season_type: Season type (REG, PRE, POST)
        week: Optional week filter
        retries: Override the default retry configuration
        server_url: Override the default server URL
        timeout_ms: Override the default timeout
        http_headers: Additional headers to send

    Returns:
        Dict containing passing statistics
    """
    config = EndpointConfig(
        method="GET",
        path="/api/statboard/passing",
        operation_id="getNgsPassingStats",
        request=models.GetNgsPassingStatsRequest(
            season=season,
            season_type=season_type,
            week=week,
        ),
        response_type=models.NgsPassingStatsResponse,
        error_status_codes=NGS_ERROR_CODES,
        request_has_query_params=True,
        server_url=server_url,
        timeout_ms=timeout_ms,
        http_headers=http_headers,
        retries=retries,
        return_raw_json=False,
    )
    return self._execute_endpoint(config)
get_passing_stats_async async 
get_passing_stats_async(
    *,
    season: int,
    season_type: str,
    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
) -> NgsPassingStatsResponse

Get NGS passing statistics (async).

Source code in griddy/nfl/endpoints/ngs/stats.py 
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
async def get_passing_stats_async(
    self,
    *,
    season: int,
    season_type: str,
    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,
) -> models.NgsPassingStatsResponse:
    """Get NGS passing statistics (async)."""
    config = EndpointConfig(
        method="GET",
        path="/api/statboard/passing",
        operation_id="getNgsPassingStats",
        request=models.GetNgsPassingStatsRequest(
            season=season,
            season_type=season_type,
            week=week,
        ),
        response_type=models.NgsPassingStatsResponse,
        error_status_codes=NGS_ERROR_CODES,
        request_has_query_params=True,
        server_url=server_url,
        timeout_ms=timeout_ms,
        http_headers=http_headers,
        retries=retries,
        return_raw_json=False,
    )
    return await self._execute_endpoint_async(config)
get_receiving_stats 
get_receiving_stats(
    *,
    season: int,
    season_type: str,
    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
) -> NgsReceivingStatsResponse

Get NGS receiving statistics.

Returns detailed receiving statistics including separation, cushion, YAC over expectation, and more.

PARAMETER DESCRIPTION
season

The season year (e.g., 2025)

TYPE: int

season_type

Season type (REG, PRE, POST)

TYPE: str

week

Optional week filter

TYPE: Optional[int] DEFAULT: None

retries

Override the default retry configuration

TYPE: OptionalNullable[RetryConfig] DEFAULT: UNSET

server_url

Override the default server URL

TYPE: Optional[str] DEFAULT: None

timeout_ms

Override the default timeout

TYPE: Optional[int] DEFAULT: None

http_headers

Additional headers to send

TYPE: Optional[Mapping[str, str]] DEFAULT: None

RETURNS DESCRIPTION
NgsReceivingStatsResponse

NgsReceivingStatsResponse containing receiving statistics
Source code in griddy/nfl/endpoints/ngs/stats.py 
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
def get_receiving_stats(
    self,
    *,
    season: int,
    season_type: str,
    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,
) -> models.NgsReceivingStatsResponse:
    """Get NGS receiving statistics.

    Returns detailed receiving statistics including separation,
    cushion, YAC over expectation, and more.

    Args:
        season: The season year (e.g., 2025)
        season_type: Season type (REG, PRE, POST)
        week: Optional week filter
        retries: Override the default retry configuration
        server_url: Override the default server URL
        timeout_ms: Override the default timeout
        http_headers: Additional headers to send

    Returns:
        NgsReceivingStatsResponse containing receiving statistics
    """
    config = EndpointConfig(
        method="GET",
        path="/api/statboard/receiving",
        operation_id="getNgsReceivingStats",
        request=models.GetNgsReceivingStatsRequest(
            season=season,
            season_type=season_type,
            week=week,
        ),
        response_type=models.NgsReceivingStatsResponse,
        error_status_codes=NGS_ERROR_CODES,
        request_has_query_params=True,
        server_url=server_url,
        timeout_ms=timeout_ms,
        http_headers=http_headers,
        retries=retries,
        return_raw_json=False,
    )
    return self._execute_endpoint(config)
get_receiving_stats_async async 
get_receiving_stats_async(
    *,
    season: int,
    season_type: str,
    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
) -> NgsReceivingStatsResponse

Get NGS receiving statistics (async).

Source code in griddy/nfl/endpoints/ngs/stats.py 
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
async def get_receiving_stats_async(
    self,
    *,
    season: int,
    season_type: str,
    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,
) -> models.NgsReceivingStatsResponse:
    """Get NGS receiving statistics (async)."""
    config = EndpointConfig(
        method="GET",
        path="/api/statboard/receiving",
        operation_id="getNgsReceivingStats",
        request=models.GetNgsReceivingStatsRequest(
            season=season,
            season_type=season_type,
            week=week,
        ),
        response_type=models.NgsReceivingStatsResponse,
        error_status_codes=NGS_ERROR_CODES,
        request_has_query_params=True,
        server_url=server_url,
        timeout_ms=timeout_ms,
        http_headers=http_headers,
        retries=retries,
        return_raw_json=False,
    )
    return await self._execute_endpoint_async(config)
get_rushing_stats 
get_rushing_stats(
    *,
    season: int,
    season_type: str,
    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
) -> NgsRushingStatsResponse

Get NGS rushing statistics.

Returns detailed rushing statistics including time to LOS, rush yards over expected, efficiency, and more.

PARAMETER DESCRIPTION
season

The season year (e.g., 2025)

TYPE: int

season_type

Season type (REG, PRE, POST)

TYPE: str

week

Optional week filter

TYPE: Optional[int] DEFAULT: None

retries

Override the default retry configuration

TYPE: OptionalNullable[RetryConfig] DEFAULT: UNSET

server_url

Override the default server URL

TYPE: Optional[str] DEFAULT: None

timeout_ms

Override the default timeout

TYPE: Optional[int] DEFAULT: None

http_headers

Additional headers to send

TYPE: Optional[Mapping[str, str]] DEFAULT: None

RETURNS DESCRIPTION
NgsRushingStatsResponse

NgsRushingStatsResponse containing rushing statistics
Source code in griddy/nfl/endpoints/ngs/stats.py 
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
def get_rushing_stats(
    self,
    *,
    season: int,
    season_type: str,
    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,
) -> models.NgsRushingStatsResponse:
    """Get NGS rushing statistics.

    Returns detailed rushing statistics including time to LOS,
    rush yards over expected, efficiency, and more.

    Args:
        season: The season year (e.g., 2025)
        season_type: Season type (REG, PRE, POST)
        week: Optional week filter
        retries: Override the default retry configuration
        server_url: Override the default server URL
        timeout_ms: Override the default timeout
        http_headers: Additional headers to send

    Returns:
        NgsRushingStatsResponse containing rushing statistics
    """
    config = EndpointConfig(
        method="GET",
        path="/api/statboard/rushing",
        operation_id="getNgsRushingStats",
        request=models.GetNgsRushingStatsRequest(
            season=season,
            season_type=season_type,
            week=week,
        ),
        response_type=models.NgsRushingStatsResponse,
        error_status_codes=NGS_ERROR_CODES,
        request_has_query_params=True,
        server_url=server_url,
        timeout_ms=timeout_ms,
        http_headers=http_headers,
        retries=retries,
        return_raw_json=False,
    )
    return self._execute_endpoint(config)
get_rushing_stats_async async 
get_rushing_stats_async(
    *,
    season: int,
    season_type: str,
    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
) -> NgsRushingStatsResponse

Get NGS rushing statistics (async).

Source code in griddy/nfl/endpoints/ngs/stats.py 
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
async def get_rushing_stats_async(
    self,
    *,
    season: int,
    season_type: str,
    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,
) -> models.NgsRushingStatsResponse:
    """Get NGS rushing statistics (async)."""
    config = EndpointConfig(
        method="GET",
        path="/api/statboard/rushing",
        operation_id="getNgsRushingStats",
        request=models.GetNgsRushingStatsRequest(
            season=season,
            season_type=season_type,
            week=week,
        ),
        response_type=models.NgsRushingStatsResponse,
        error_status_codes=NGS_ERROR_CODES,
        request_has_query_params=True,
        server_url=server_url,
        timeout_ms=timeout_ms,
        http_headers=http_headers,
        retries=retries,
        return_raw_json=False,
    )
    return await self._execute_endpoint_async(config)