Computes an NFL figure from a structured query rather than looking one up: a population (position, qualifying threshold), a window (seasons, weeks, a team span, a coach's tenure), one named measure, and one operation (leaders, rank, count, only-who, a per-season streak, or a share of a total). Answers questions the verified panel has no pre-computed row for — qualified superlatives, multi-season streaks, derived rates. Every response carries the executed method, the population size, the measure's definition and the data version it ran against. Figures are computed on request from nflverse data and are labelled as computed, not verified. A figure that cannot be served comes back with the reason and the nearest thing covered.
Fantasy measures answer in the convention `scoring` names — "standard", "half_ppr" or "ppr" — and default to half-PPR when none is named; the response says which it used. A bare "PPR" means full PPR.
measure.key takes a measure name ("rushing_yards", "half_ppr_points") or a verified panel metric key ("key_player_stats.rushing.yards", "fantasy_scoring.half_ppr_points"). A panel metric key this tool does not compute is refused with the reason.
View input schema
{
"type": "object",
"properties": {
"population": {
"type": "object",
"properties": {
"entity": {
"type": "string",
"enum": [
"player",
"team"
]
},
"position": {
"maxItems": 6,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 4
}
},
"exclude_position": {
"maxItems": 6,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 4
}
},
"qualify": {
"type": "object",
"properties": {
"measure": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"op": {
"type": "string",
"enum": [
">=",
">",
"<=",
"<",
"="
]
},
"value": {
"type": "number"
}
},
"required": [
"measure",
"op",
"value"
],
"additionalProperties": false
},
"entity_name": {
"type": "string",
"minLength": 1,
"maxLength": 64
}
},
"required": [
"entity"
],
"additionalProperties": false
},
"window": {
"anyOf": [
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "seasons"
},
"seasons": {
"minItems": 1,
"maxItems": 20,
"type": "array",
"items": {
"type": "integer",
"minimum": 1999,
"maximum": 2100
}
}
},
"required": [
"kind",
"seasons"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "last_n_seasons"
},
"n": {
"type": "integer",
"minimum": 1,
"maximum": 20
}
},
"required": [
"kind",
"n"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "weeks"
},
"season": {
"type": "integer",
"minimum": 1999,
"maximum": 2100
},
"weeks": {
"minItems": 1,
"maxItems": 23,
"type": "array",
"items": {
"type": "integer",
"minimum": 1,
"maximum": 23
}
}
},
"required": [
"kind",
"season",
"weeks"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "since_debut"
}
},
"required": [
"kind"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "with_team"
},
"team": {
"type": "string",
"minLength": 2,
"maxLength": 4
},
"seasons": {
"minItems": 1,
"maxItems": 20,
"type": "array",
"items": {
"type": "integer",
"minimum": 1999,
"maximum": 2100
}
}
},
"required": [
"kind",
"team"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "coach_tenure"
},
"coach": {
"type": "string",
"minLength": 2,
"maxLength": 60
},
"team": {
"type": "string",
"minLength": 2,
"maxLength": 4
}
},
"required": [
"kind",
"coach"
],
"additionalProperties": false
}
]
},
"measure": {
"type": "object",
"properties": {
"key": {
"type": "string",
"minLength": 1,
"maxLength": 64
}
},
"required": [
"key"
],
"additionalProperties": false
},
"scoring": {
"type": "string",
"enum": [
"standard",
"half_ppr",
"ppr"
]
},
"op": {
"anyOf": [
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "leaders"
},
"k": {
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"required": [
"kind"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "rank"
},
"direction": {
"type": "string",
"enum": [
"asc",
"desc"
]
},
"k": {
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"required": [
"kind",
"direction"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "count_where"
},
"op": {
"type": "string",
"enum": [
">=",
">",
"<=",
"<",
"="
]
},
"value": {
"type": "number"
}
},
"required": [
"kind",
"op",
"value"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "only_who"
},
"op": {
"type": "string",
"enum": [
">=",
">",
"<=",
"<",
"="
]
},
"value": {
"type": "number"
}
},
"required": [
"kind",
"op",
"value"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "streak_each"
},
"op": {
"type": "string",
"enum": [
">=",
">",
"<=",
"<",
"="
]
},
"value": {
"type": "number"
},
"n_seasons": {
"type": "integer",
"minimum": 2,
"maximum": 10
}
},
"required": [
"kind",
"op",
"value",
"n_seasons"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "share_of"
},
"part": {
"anyOf": [
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "seasons"
},
"seasons": {
"minItems": 1,
"maxItems": 20,
"type": "array",
"items": {
"type": "integer",
"minimum": 1999,
"maximum": 2100
}
}
},
"required": [
"kind",
"seasons"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "last_n_seasons"
},
"n": {
"type": "integer",
"minimum": 1,
"maximum": 20
}
},
"required": [
"kind",
"n"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "weeks"
},
"season": {
"type": "integer",
"minimum": 1999,
"maximum": 2100
},
"weeks": {
"minItems": 1,
"maxItems": 23,
"type": "array",
"items": {
"type": "integer",
"minimum": 1,
"maximum": 23
}
}
},
"required": [
"kind",
"season",
"weeks"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "since_debut"
}
},
"required": [
"kind"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "with_team"
},
"team": {
"type": "string",
"minLength": 2,
"maxLength": 4
},
"seasons": {
"minItems": 1,
"maxItems": 20,
"type": "array",
"items": {
"type": "integer",
"minimum": 1999,
"maximum": 2100
}
}
},
"required": [
"kind",
"team"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "coach_tenure"
},
"coach": {
"type": "string",
"minLength": 2,
"maxLength": 60
},
"team": {
"type": "string",
"minLength": 2,
"maxLength": 4
}
},
"required": [
"kind",
"coach"
],
"additionalProperties": false
}
]
}
},
"required": [
"kind",
"part"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "count_weeks_where"
},
"op": {
"type": "string",
"enum": [
">=",
">",
"<=",
"<",
"="
]
},
"value": {
"type": "number"
},
"k": {
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"required": [
"kind",
"op",
"value"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "longest_streak"
},
"unit": {
"type": "string",
"const": "weeks"
},
"op": {
"type": "string",
"enum": [
">=",
">",
"<=",
"<",
"="
]
},
"value": {
"type": "number"
}
},
"required": [
"kind",
"unit",
"op",
"value"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "delta_between_seasons"
},
"from": {
"type": "integer",
"minimum": 1999,
"maximum": 2100
},
"to": {
"type": "integer",
"minimum": 1999,
"maximum": 2100
},
"k": {
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"required": [
"kind",
"from",
"to"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "rank_change"
},
"from": {
"type": "integer",
"minimum": 1999,
"maximum": 2100
},
"to": {
"type": "integer",
"minimum": 1999,
"maximum": 2100
},
"k": {
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"required": [
"kind",
"from",
"to"
],
"additionalProperties": false
}
]
}
},
"required": [
"population",
"window",
"measure",
"op"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}