{"schema":"draftadynasty.public-data-view/v1","readOnly":true,"id":"metric-definitions","title":"All football metric definitions","status":"Definitions","observedAt":"2026-09-04","snapshotId":"b0d480a5fff0c35e863d6751d6ba5c95a57817fda9f68243603c9e630491cc37","freshness":{"mode":"frozen_snapshot","status":"not_live","note":"Original capture date; opening or downloading does not refresh the source. Per-record timestamps take precedence. Definitions may describe unavailable inputs."},"boundary":"Original observations, research and definitions are provided in full. Read each record's source, period, scoring and availability. Research visibility does not promote a model into public rankings. Missing means unavailable, never zero. No account records or provider write access.","dictionary":{"notation":"JSON bracket paths; [] means every array element. CSV uses concrete zero-based indices. Types are observed, not a promise that future fields cannot change.","missing":"null is unavailable; empty array/object means an empty collection. Zero is preserved as a measured or supplied numeric value.","units":"Source-native units and scoring. Consult metric-definitions for formulas; ambiguous units remain unspecified, never inferred.","hash":"sha256 of UTF-8 JSON.stringify(data), excluding this envelope. Source receipt hashes remain inside data. CSV prefixes formula-looking text with an apostrophe; numeric signs are preserved. JSON keeps original strings."},"sourceContext":{"$":{"schemaVersion":1,"updatedAt":"2026-09-04","productPromise":"Decision-grade football context with transparent formulas, freshness, and source rights. No guaranteed outcomes or invented live prices.","sourceRegistry":{"nflverse":{"label":"nflverse","class":"open_research","url":"https://nflverse.nflverse.com/","commercialGate":"Verify each upstream dataset and attribution requirement before production use."},"nfl_ngs":{"label":"NFL Next Gen Stats","class":"official_nfl","url":"https://operations.nfl.com/gameday/technology/nfl-next-gen-stats","commercialGate":"Public metric definitions are research context; production data requires approved access and rights."},"sleeper":{"label":"Sleeper API","class":"first_party","url":"https://docs.sleeper.com/","commercialGate":"Read-only public league context; respect rate limits and platform terms."},"licensed_odds":{"label":"Licensed sportsbook feed","class":"licensed_odds","url":"https://the-odds-api.com/liveapi/guides/v4/","commercialGate":"API key, paid plan, allowed regions, attribution, storage, and redistribution rights required."},"kalshi":{"label":"Kalshi API","class":"prediction_market","url":"https://docs.kalshi.com/getting_started/orderbook_responses","commercialGate":"Public market-data use remains subject to current API and exchange terms."},"polymarket":{"label":"Polymarket public market data","class":"prediction_market","url":"https://docs.polymarket.com/market-data/overview","commercialGate":"Official public, no-auth market data is enabled for the current free noncommercial research product; re-review rights before any commercial or trading use."}}}},"query":{"view":"records","collection":"metrics","q":"","order":"source","page":1,"limit":20,"snapshot":"b0d480a5fff0c35e863d6751d6ba5c95a57817fda9f68243603c9e630491cc37"},"total":47,"offset":0,"returned":20,"pages":3,"records":[{"sourceIndex":0,"record":{"id":"dynasty-fair-value","label":"Dynasty fair value","category":"fantasy_value","formula":"Calibrated rest-of-career production + scarcity + age curve + role security","meaning":"A format-aware estimate of a player's long-horizon roster value.","decision":"Compare roster needs and trade prices without treating consensus as truth.","sourceRefs":["sleeper","nflverse"],"freshness":"Daily in season; weekly offseason","availability":"planned","tier":"free","licensedProviderRequired":false}},{"sourceIndex":1,"record":{"id":"market-value-gap","label":"Market value gap","category":"fantasy_value","formula":"DraftADynasty fair value - rights-cleared market consensus","meaning":"The disagreement between the model and a permissioned market benchmark.","decision":"Find players worth deeper review; not an automatic trade signal.","sourceRefs":["sleeper"],"freshness":"Daily","availability":"planned","tier":"pro","licensedProviderRequired":true}},{"sourceIndex":2,"record":{"id":"vorp","label":"Value over replacement","category":"fantasy_value","formula":"Projected fantasy points - format-specific replacement baseline","meaning":"How much usable scoring a player adds above a waiver-level option.","decision":"Compare positions on the same lineup-value scale.","sourceRefs":["nflverse","sleeper"],"freshness":"Weekly","availability":"planned","tier":"free","licensedProviderRequired":false}},{"sourceIndex":3,"record":{"id":"weekly-range","label":"Weekly floor / median / ceiling","category":"fantasy_value","formula":"10th / 50th / 90th percentiles from the outcome distribution","meaning":"A range of plausible weekly fantasy outcomes instead of one brittle point estimate.","decision":"Balance lineup safety and upside.","sourceRefs":["nflverse"],"freshness":"After news; at least daily","availability":"planned","tier":"pro","licensedProviderRequired":false}},{"sourceIndex":4,"record":{"id":"lineup-win-probability","label":"Lineup win-probability lift","category":"fantasy_value","formula":"P(win with player) - P(win with replacement)","meaning":"The estimated matchup impact of a start/sit decision.","decision":"Rank close lineup calls by actual matchup leverage.","sourceRefs":["sleeper","nflverse"],"freshness":"Hourly game day","availability":"planned","tier":"elite","licensedProviderRequired":false}},{"sourceIndex":5,"record":{"id":"role-security","label":"Role security","category":"fantasy_value","formula":"Weighted stability of snaps, routes, touches, depth-chart status, and contract horizon","meaning":"How likely the current opportunity is to persist.","decision":"Separate sustainable value from fragile short-term production.","sourceRefs":["nflverse","sleeper"],"freshness":"Daily","availability":"planned","tier":"pro","licensedProviderRequired":false}},{"sourceIndex":6,"record":{"id":"rookie-hit-probability","label":"Rookie hit probability","category":"fantasy_value","formula":"Calibrated probability of crossing position- and round-specific fantasy thresholds","meaning":"A distribution-aware rookie outcome estimate.","decision":"Compare rookies with veterans and future picks.","sourceRefs":["nflverse"],"freshness":"Weekly offseason","availability":"research_only","tier":"pro","licensedProviderRequired":false}},{"sourceIndex":7,"record":{"id":"format-scarcity","label":"Format scarcity","category":"fantasy_value","formula":"Replacement gap adjusted for teams, starters, premium scoring, and superflex","meaning":"How league settings change positional leverage.","decision":"Prevent one-size-fits-all rankings.","sourceRefs":["sleeper"],"freshness":"On league load","availability":"planned","tier":"free","licensedProviderRequired":false}},{"sourceIndex":8,"record":{"id":"epa-per-play","label":"EPA per play","category":"player_performance","formula":"Mean change in expected points on credited plays","meaning":"Down-, distance-, field-position-, and score-aware efficiency.","decision":"Compare player and offense efficiency beyond raw yards.","sourceRefs":["nflverse"],"freshness":"Postgame","availability":"planned","tier":"free","licensedProviderRequired":false}},{"sourceIndex":9,"record":{"id":"success-rate","label":"Success rate","category":"player_performance","formula":"Share of plays with positive EPA","meaning":"How consistently an offense or player keeps drives on schedule.","decision":"Distinguish steady efficiency from a few explosive plays.","sourceRefs":["nflverse"],"freshness":"Postgame","availability":"planned","tier":"free","licensedProviderRequired":false}},{"sourceIndex":10,"record":{"id":"cpoe","label":"Completion percentage over expected","category":"player_performance","formula":"Actual completion rate - expected completion rate","meaning":"Quarterback completion performance adjusted for throw difficulty.","decision":"Evaluate passing accuracy in context.","sourceRefs":["nflverse","nfl_ngs"],"freshness":"Postgame","availability":"planned","tier":"pro","licensedProviderRequired":false}},{"sourceIndex":11,"record":{"id":"pressure-to-sack","label":"Pressure-to-sack rate","category":"player_performance","formula":"Sacks / pressured dropbacks","meaning":"How often quarterback pressure becomes a sack.","decision":"Price matchup and quarterback pocket-management risk.","sourceRefs":["nflverse"],"freshness":"Weekly","availability":"planned","tier":"pro","licensedProviderRequired":false}},{"sourceIndex":12,"record":{"id":"ryoe","label":"Rushing yards over expected","category":"player_performance","formula":"Actual rushing yards - model-expected rushing yards","meaning":"Rushing output relative to blocking, defenders, location, and speed context.","decision":"Separate runner contribution from environment where approved tracking data exists.","sourceRefs":["nfl_ngs"],"freshness":"Postgame","availability":"research_only","tier":"elite","licensedProviderRequired":true}},{"sourceIndex":13,"record":{"id":"yards-after-contact","label":"Yards after contact","category":"player_performance","formula":"Rushing yards gained after first charted contact / attempts","meaning":"Contact-balance production independent of untouched running lanes.","decision":"Evaluate rushing sustainability and tackle-breaking style.","sourceRefs":["nflverse"],"freshness":"Weekly","availability":"planned","tier":"pro","licensedProviderRequired":false}},{"sourceIndex":14,"record":{"id":"targets-per-route","label":"Targets per route run","category":"player_performance","formula":"Targets / routes run","meaning":"How often a player earns a target while actually in the pattern.","decision":"Detect demand before box-score volume catches up.","sourceRefs":["nflverse"],"freshness":"Weekly","availability":"planned","tier":"pro","licensedProviderRequired":false}},{"sourceIndex":15,"record":{"id":"yards-per-route","label":"Yards per route run","category":"player_performance","formula":"Receiving yards / routes run","meaning":"Receiving efficiency on every route, not only targets.","decision":"Compare pass catchers with different snap and target totals.","sourceRefs":["nflverse"],"freshness":"Weekly","availability":"planned","tier":"free","licensedProviderRequired":false}},{"sourceIndex":16,"record":{"id":"weighted-opportunity","label":"Weighted opportunity","category":"player_performance","formula":"Position-specific blend of routes, targets, carries, air yards, and high-value touches","meaning":"A role-volume signal that weights touches by fantasy importance.","decision":"Find workload changes before touchdowns distort perception.","sourceRefs":["nflverse"],"freshness":"Postgame","availability":"planned","tier":"pro","licensedProviderRequired":false}},{"sourceIndex":17,"record":{"id":"neutral-proe","label":"Neutral pass rate over expected","category":"player_performance","formula":"Actual neutral-situation pass rate - expected pass rate","meaning":"How aggressively a team chooses to pass after situation adjustment.","decision":"Project team-level opportunity and game-script sensitivity.","sourceRefs":["nflverse"],"freshness":"Weekly","availability":"planned","tier":"pro","licensedProviderRequired":false}},{"sourceIndex":18,"record":{"id":"opponent-adjusted-residual","label":"Opponent-adjusted performance","category":"player_performance","formula":"Actual output - expected output given opponent, role, venue, and game state","meaning":"A residual that controls for defensive and situational difficulty.","decision":"Avoid overreacting to raw production against extreme opponents.","sourceRefs":["nflverse"],"freshness":"Weekly","availability":"research_only","tier":"elite","licensedProviderRequired":false}},{"sourceIndex":19,"record":{"id":"scheme-fit","label":"Scheme-fit score","category":"player_performance","formula":"Similarity-weighted performance by personnel, motion, play action, alignment, and concept","meaning":"How a player's demonstrated strengths fit the current offensive design.","decision":"Translate coordinator and role changes into explicit projection adjustments.","sourceRefs":["nflverse"],"freshness":"Weekly","availability":"research_only","tier":"elite","licensedProviderRequired":false}}],"points":[],"collections":[{"path":"metrics","count":47,"hasAdp":false}],"exportScope":"current_page_only","note":"This view contains only the selected page. Follow next to read every match; full JSON and CSV exports remain available. Keep snapshotId consistent across pages. Source indices are zero-based positions in the original collection, not rankings.","links":{"self":"https://draftadynasty.com/api/data/metric-definitions/view?view=records&q=&order=source&page=1&limit=20&collection=metrics&snapshot=b0d480a5fff0c35e863d6751d6ba5c95a57817fda9f68243603c9e630491cc37","next":"https://draftadynasty.com/api/data/metric-definitions/view?view=records&q=&order=source&page=2&limit=20&collection=metrics&snapshot=b0d480a5fff0c35e863d6751d6ba5c95a57817fda9f68243603c9e630491cc37","previous":null,"first":"https://draftadynasty.com/api/data/metric-definitions/view?view=records&q=&order=source&page=1&limit=20&collection=metrics&snapshot=b0d480a5fff0c35e863d6751d6ba5c95a57817fda9f68243603c9e630491cc37","human":"https://draftadynasty.com/data/metric-definitions?view=records&q=&order=source&page=1&limit=20&collection=metrics","currentPageCsv":"https://draftadynasty.com/api/data/metric-definitions/view?view=records&q=&order=source&page=1&limit=20&collection=metrics&snapshot=b0d480a5fff0c35e863d6751d6ba5c95a57817fda9f68243603c9e630491cc37&format=csv","fullJson":"https://draftadynasty.com/api/data/metric-definitions","fullCsv":"https://draftadynasty.com/api/data/metric-definitions?format=csv"}}