Analytics
16 independently-subscribable analytics.* feeds — the real-time outputs of 14 production ML models and the algorithmic layer on top of them. Each feed answers one question and is delivered as its own stream, so you subscribe to exactly what your product needs. For how each model is built and calibrated, see the Models reference →
driverNumbers filter works on analytics.strategy, analytics.race-odds, analytics.gap-projection, analytics.tire-strategy, and analytics.qualifying. For analytics.team-points the payload is small (10 constructors) — no filter needed.Subscribe with the feedId via webhook or SSE. The badge shows the feed's access class: free feeds are open to every plan, live feeds require the Developer plan, and analytics feeds require the Custom plan.
analytics.strategyRace Strategy Analyticsanalytics
Per-driver decision surfaces: pit (probability, window, plan, call), threat (undercut/overcut/overtake), pace (LTOE, clean pace, tyre health), reliability (DNF risk); plus session-level raceState (safety car probability, strategy leverage, pit-cycle openness T(L)).
Backed by: pit stop probability, overtake probability, undercut threat, pace normalization (LTOE), safety car probability, pit-stop count, DNF risk, pace mode, EKF tire health, competitor intelligence. How the models work →
| Field | Type | Description |
|---|---|---|
regulationsEra | string | "2026" or "pre-2026". All 2026 models have era-specific calibration applied. |
raceState.pSafetyCar | number | P(any SC/VSC deployment next lap). Session-level — same value for all drivers. Gradient-boosted classifier with a self-exciting component over historical incident data. |
raceState.pVsc | number | P(virtual SC specifically). Absent (not null) when the 3-class SC model is not loaded. |
raceState.pFullSc | number | P(full safety car). Absent (not null) when the 3-class SC model is not loaded. |
raceState.strategyLeverage | object | Field-level aggression-favored signal (strategy pocket): leverage (0–1, high only when BOTH SC probability and field degradation are elevated), inPocket, leaning ("aggressive" | "neutral"), note. |
competitorIntelligence | object | Field-level pit-window estimates. Omitted for the first few laps before the engine has data. |
drivers[].pit | object | The pit decision surface. pNextLap: 0–1 gradient-boosted-ensemble probability of a stop this lap, over a rolling multi-lap feature window. pWithin3Laps: derived window framing, 1 − (1 − pNextLap)^3. recommended: true when the probability clears the session's era-adjusted decision threshold. |
drivers[].pit.window | object | Pit-window state from the survival composition: medianStintLength, pWithin5Laps, expectedResidualLaps, survivalPWithin3Laps (survival-model estimate — a different estimator from the binomial pit.pWithin3Laps). |
drivers[].pit.plan | object | Race-plan context: mostLikelyStops, expectedStops, and pByStops keyed "1" | "2" | "3+" (sums to 1.0). Multiclass gradient-boosted model over circuit, grid, weather, and starting compound. |
drivers[].pit.call | object | Feedback-Stackelberg pit-sequencing recommendation vs the rival: action, rivalResponse, equilibriumGapSec (null once both cars have completed mandatory stops), rivalPosition, why { label, detail, tone }. |
drivers[].threat.undercut | object | Present when the car ahead is within the strategic gap threshold: score, viable, gapToCarAheadSec, estimatedDeltaSec, pSuccess. |
drivers[].threat.undercut.call | object | Calibrated undercut-timing call (race only, target tyre age known): recommend ("UNDERCUT_NOW" | "WAIT" | "HOLD"), strikeInLaps, pSuccess, pNow. The recommendation gates on the worst case (target covers next lap); pSuccess/pNow are calibrated against realized outcomes with the target's reaction marginalized. |
drivers[].threat.overcut | object|absent | First-class slot for the overcut model — absent until its rebuilt predictor is serving. Absent means "not served", never "no threat". |
drivers[].threat.overtake | object | pWithin3Laps: 0–1 gradient-boosted-ensemble probability of a position gain via overtake within 3 laps. Circuit overtake index applied. |
drivers[].pace | object | The pace surface. mode: "PUSH" | "HOLD" | "MANAGE" | "WARM_UP" | "DELTA" (lap-time variance and LTOE-based classification). ltoeSec (Lap Time Over Expected — negative = faster than expected), expectedLapTimeSec, actualLapTimeSec, confidenceScale (1.0 once 3+ races of the season's data exist), cleanPaceSec (fuel-corrected lap time). |
drivers[].pace.tyre | object | Tyre condition: health (0–1), healthPct, degRateSecPerLap, stintLaps, cliffLapPredicted, remainingUsefulLife, cliffRisk, and cliff { p, withinLaps, detected, lapsToCliff }. Derived from a Kalman filter on the lap-delta series. |
drivers[].reliability | object | dnfRisk (0–1 retirement hazard), constructorHazardRate, lapsTo50PctSurvival. |
analytics.race-oddsRace Outcome Probabilitiesanalytics
CTMC position distribution, podium/points odds, expected points, fastest-lap probability, H2H vs teammate, and same-team pairs — plus, during the opening laps, the glass-box combined win-prob line (model prior pooled with the pre-race market line) that anchors the early race.
Backed by: CTMC win probability, fastest lap probability, combined win-prob line (log-opinion pool). How the models work →
| Field | Type | Description |
|---|---|---|
drivers[].positionDistribution | number[20] | 20-element Monte Carlo probability vector. Index 0 = P(finish 1st). Sums to ≤1.0 (lower for retired drivers). |
drivers[].mostLikelyPosition | number | 1-based index of the highest-probability position slot. |
drivers[].podiumProbability | number | P(finish P1–P3). Sum of positionDistribution[0..2]. |
drivers[].top10Probability | number | Sum of positionDistribution[0..9]. Equivalent to P(score points). |
drivers[].expectedPoints | number | Expected F1 points from the distribution × points structure, plus fastest-lap bonus weighted by fastestLapProbability. |
drivers[].lapsLedExpected | number | Expected race laps led from the current position. CTMC forward integration. |
drivers[].fastestLapProbability | number | L1-normalised P(set the session fastest lap). Field sums to 1.0. |
drivers[].positionChange | object | CTMC forward projection at next3Laps/next5Laps/next10Laps: gainAtLeast1, loseAtLeast1, holdPosition. |
drivers[].h2hVsTeammate | number|null | P(this driver finishes ahead of team-mate). null when team-mate has no distribution. |
drivers[].gridPosition | number | Starting grid slot. Present once real qualifying data is loaded — never a fallback value. |
drivers[].expectedPlaceDifferential | number | Expected places gained vs. grid (positive = gaining): grid − E[finish] from the position distribution. The fantasy place-differential projection. |
pairs[] | object[] | Same-team H2H pairs: constructorId, driverA/B, pABeatsB, pBBeatsA, pTie. |
combinedLine | object|absent | Glass-box decomposition of the pre-race grid anchor still shaping the opening-lap win probs: rule "log", members[] (each a name — "model"/"market" — and its pool weight), and outcomes[] (a full DriverRef per driver plus forecasts [model, market] and the assembled pooled probability). Absent once the anchor decays or when no market line was available. |
analytics.true-paceTrue Pace Rankinganalytics
Who's genuinely fastest: each car's session pace stripped of fuel load, tyre age, and traffic (dirty air), ranked — the public-data proxy for hidden long-run pace.
Backed by: True-pace deconvolution. How the models work →
| Field | Type | Description |
|---|---|---|
drivers[].truePaceSec | number | Deconvolved lap pace (s): the session's trailing clean-lap mean with fuel load, tyre age and traffic (dirty air) stripped — the car's fresh-tyre clean-air pace. |
drivers[].truePaceRelSec | number | True pace relative to the FIELD MEDIAN (s/lap); negative = faster than the field. Comparable across sessions. Compute gap-to-fastest from truePaceSec if needed. |
drivers[].rank | number | 1 = genuinely fastest. Field-relative true pace predicts finish position ~2× better than raw fuel-corrected pace. |
analytics.gap-projectionGap to Leader Projectionanalytics
Projected gap to the race leader at race end for every driver: five percentile bands (p10–p90) plus P(lapped) from Monte Carlo simulation.
Backed by: Monte Carlo gap projection. How the models work →
| Field | Type | Description |
|---|---|---|
drivers[].currentGapToLeaderSec | number | Current gap to the race leader (seconds). |
drivers[].expectedGapToLeaderSec | number | Monte Carlo mean projected gap at race end. |
drivers[].p10GapSec | number | 10th-percentile projected gap — optimistic scenario. |
drivers[].p50GapSec | number | Median projected gap. |
drivers[].p90GapSec | number | 90th-percentile projected gap — pessimistic scenario. |
drivers[].probabilityLapped | number | P(driver is lapped by race end). Typically < 0.05 for active drivers. |
analytics.winning-marginWinning Margin Projectionanalytics
Session-level race outlook: projected winning margin (P1–P2) with percentile bands, the probability the margin lands above 5s / 10s / below 3s, and the safety-car collapse risk that resets the lead.
Backed by: Monte Carlo winning margin. How the models work →
| Field | Type | Description |
|---|---|---|
leadBattle.leader / leadBattle.runnerUp | object | Current P1 and P2 (each a full DriverRef: number, driverId, tla, name, team). |
leadBattle.currentMarginSec | number | Current P1–P2 gap in seconds. |
leadBattle.expectedFinalMarginSec | number | Expected P1–P2 gap at race end. Mixture of the no-SC linear drift and the post-SC reset distribution. |
leadBattle.p10MarginSec / p50MarginSec / p90MarginSec | number | Percentile bands from 5,000 Monte Carlo samples. |
leadBattle.probabilityMarginAbove5 / Above10 | number | P(final margin > 5s) / P(> 10s). |
leadBattle.probabilityMarginBelow3 | number | P(final margin < 3s) — close-finish probability. |
leadBattle.scCollapseRisk | number | P(safety car before race end) — the dominant driver of margin collapse. Gaps reset toward ~1.5s at an SC restart. |
analytics.race-previewPre-Race Previewanalytics
Pre-race projections in two stages: post-final-practice (long-run pace ranking, circuit strategy priors, weather outlook) and post-qualifying (classification with measured pole margin, pace-vs-grid deltas, derived race distance, pre-race pit-stop-count distributions, and — when a market line is available — the glass-box combined win-prob line pooling the model prior with the market).
Backed by: Practice long-run pace summary, Circuit priors, pit-stop count, combined win-prob line (log-opinion pool). How the models work →
| Field | Type | Description |
|---|---|---|
stage | string | "practice" (final practice ended) or "grid" (qualifying ended). |
circuitId | string | Canonical RaceHooks circuit slug (e.g. "monaco"). |
drivers[] | object | Each entry is a full DriverRef (number, driverId, tla, name, team) plus the stage-specific fields below. |
drivers[].practicePace | object | relPacePct (lower = faster), longRunDone, primaryCompound, lapsCompleted, sessionType, paceRank. Long-run drivers rank ahead of short-run-only drivers — long-run pace is the race-pace signal. |
strategy.compoundDeg[] | object | Per-compound degradation prior (sec/lap) for this circuit, from the post-weekend prior pipeline. |
strategy.pitLaneDeltaSec | number | Circuit pit-lane time loss in seconds. |
strategy.scTimeCostSecPerLap | number | Time cost of a safety-car lap at this circuit vs green pace. |
strategy.redFlagBaseRate | number | Fraction of sessions at this circuit with at least one red flag (2018–2025). |
qualifying | object | Grid stage: session classification (order with segments), pole lap, and the MEASURED pole margin in ms. The official grid may differ after penalties. |
drivers[].paceVsGridDelta | number | Grid stage: practice pace rank minus qualifying position — positive = raced faster in practice than qualified (a classic recovery-drive signal). |
drivers[].pitStopCount | object | Grid stage: pre-race stop-count distribution (pOneStop/pTwoStop/pThreePlusStop/expectedStops) assuming a medium-compound start; race distance derived from the FIA 305 km rule. |
scheduledRaceLaps | number|null | Grid stage: derived race distance in laps (FIA 305 km rule; Monaco 260 km). null when circuit length is unknown. |
combinedLine | object|absent | Grid stage: glass-box pre-race combined win-prob line pooling the model prior with the de-vigged market line. rule "log", members[] (name "model"/"market" + weight), outcomes[] (full DriverRef + forecasts [model, market] + assembled pooled probability). Absent when no market line was available for the race. |
analytics.race-durationRace Duration Projectionanalytics
Projected total race time with p10/p90 bands, expected winner lap time, red-flag probability, and P(race exceeds the 2-hour FIA limit).
Backed by: Race-finish-time formula (LTOE + SC cost + red-flag base rates). How the models work →
| Field | Type | Description |
|---|---|---|
expectedRaceTimeMinutes | number | Expected total race duration in minutes: elapsed + remaining racing time + expected SC and red-flag time loss. |
p10RaceTimeMinutes / p90RaceTimeMinutes | number | 10th/90th percentile race-duration band. |
expectedWinnerLapTimeSec | number | Expected winner average lap time over the remaining laps (degradation-adjusted). |
probabilityRedFlag | number | Rule-based P(red flag before race end): circuit base rate boosted by wet running, lap-1 chaos, SC history, and retirements. |
probabilityOvertimeSession | number | P(race exceeds the 2-hour FIA time limit). |
scDeployedCount | number | Safety-car deployments so far this race. |
analytics.tire-strategyTire Strategy Probabilityanalytics
Next-compound probabilities for drivers approaching a pit window (pitStopProbabilityNext3Laps > 0.25 — the within-3 scale, not the per-lap pitStopProbability). Sparse — fires only when relevant.
Backed by: tyre compound. How the models work →
| Field | Type | Description |
|---|---|---|
drivers[].pitProbability | number | Current pit-stop probability — why the driver is in the sparse set. |
drivers[].nextCompoundProbability.soft | number | P(next compound = soft). |
drivers[].nextCompoundProbability.medium | number | P(next compound = medium). |
drivers[].nextCompoundProbability.hard | number | P(next compound = hard). |
drivers[].nextCompoundProbability.wetWeather | number | High-recall merged Inter+Wet class. Zeroed on a dry track; elevated when a weather event is approaching. |
drivers[].nextCompoundProbability.dryCompoundProbabilities | object | Dry-only renormalised view { soft, medium, hard } summing to 1 — use on a dry track where wetWeather is 0. |
analytics.team-pointsTeam Points Analyticsanalytics
Constructor-level expected points from discrete joint position-distribution convolution, with P(both drivers score) and full points distribution.
Backed by: CTMC win probability, constructor points convolution. How the models work →
| Field | Type | Description |
|---|---|---|
constructors[].constructorId | string | Team identifier (e.g. "red-bull", "ferrari", "mclaren"). |
constructors[].expectedConstructorPoints | number | Expected combined points from both drivers, via discrete convolution of joint position distributions — analytically exact. |
constructors[].scoringBothDriversProbability | number | P(both drivers finish top 10). Joint probability from the distribution product. |
constructors[].podiumBothDriversProbability | number | P(both drivers finish on the podium). Same independence product over P1–P3. |
constructors[].pointsDistribution | number[] | P(team scores exactly K combined points) for K = 0…44. |
analytics.championship-probabilityChampionship Win Probabilityanalytics
Post-race championship win probability for every driver (WDC) and constructor (WCC). afterRaceId identifies which race the data reflects.
Backed by: season simulator (infer_scwp). How the models work →
| Field | Type | Description |
|---|---|---|
seasonYear | number | Championship season the projection covers. |
afterRaceId | string | The most recent official race the probabilities are computed through. |
simulationsRun | number | Monte Carlo iterations behind the projection. |
drivers[] | object | WDC row — a full DriverRef (number, driverId, tla, name, team) plus the fields below. |
drivers[].scwp | number | P(this driver wins the WDC). Field sums to ≤1.0. |
drivers[].scwpTop3 | number | P(this driver finishes top-3 in the championship). |
drivers[].expectedFinalPoints | number | Expected end-of-season points total. |
drivers[].championshipDeficit | number | Points behind the current championship leader (0 for the leader). |
constructors[].constructorId | string | Canonical team slug (e.g. "mclaren"). |
constructors[].ccwp | number | P(this team wins the WCC). Field sums to ≤1.0. |
constructors[].ccwpTop3 | number | P(this team finishes top-3 in the constructors' championship). |
constructors[].expectedFinalPoints | number | Expected end-of-season combined points. |
constructors[].championshipDeficit | number | Points behind the leading constructor. |
analytics.qualifyingQualifying Analyticsanalytics
Per-sector fastest probabilities and per-driver pace deltas during qualifying, with pole-margin probability. Fires after each personal best.
Backed by: qualifying pace, calibrated qualifying distribution. How the models work →
| Field | Type | Description |
|---|---|---|
segment | string | Active segment: "Q1", "Q2", or "Q3". |
poleLeader | string | Driver number currently projected to take pole (lowest sum of sector deltas). |
poleMarginAbove100ms | number | P(gap between pole and P2 > 0.1s). From the calibrated margin model. |
sectors.s1.drivers[].pFastest | number | P(this driver sets fastest S1). L1-normalised across drivers with pace data. |
sectors.s1.drivers[].predictedDeltaMs | number | Predicted S1 delta vs. session median (ms). Negative = faster. |
drivers[].sector1DeltaMs | number|null | Predicted S1 delta vs. session median (ms). null when the qualifying pace model is not loaded. |
drivers[].elimination | object | Q1/Q2 only, once most of the field has predictions: pEliminatedQ1, pEliminatedQ2, pReachesQ3, projectedFinalQualifyingPosition — rank-based order statistics over the predicted field. |
analytics.sector-paceSector Pace Analyticsanalytics
Per-sector pace deltas with anomaly detection; fires when a sector-pace anomaly is detected.
Backed by: sector pace analyzer. How the models work →
| Field | Type | Description |
|---|---|---|
data.driver | object | The driver the anomaly is for (full DriverRef: number, driverId, tla, name, team). |
data.s1 / s2 / s3 | object|null | Per-sector reading: deltaSec vs the rolling median baseline, baselineMs, currentMs, cleanLapCount. |
data.anomalyDetected | boolean | true when a sector departs its baseline beyond the warning threshold. |
data.anomalySector / anomalyLevel | number|string | Which sector (1–3) and severity ("WARNING" | "CRITICAL"). |
data.classifiedCause | string|null | "RAIN" | "TIRE_CLIFF" | "INCIDENT" | "UNKNOWN" — rule-based cause classification. |
data.rainConfidence | number | 0–1 confidence the anomaly is rain-driven. |
data.crossDriverCorrelated | boolean | true when ≥3 cars show the same-sector anomaly on the same lap (weather, not car-specific). |
data.driversAffectedSameSector | object[] | Other cars flagged in the same sector this lap — a full DriverRef each. |
analytics.battleStrategy Battle Alertanalytics
On-track battle status between a driver and the car directly ahead (closing, holding, defending).
Backed by: strategy battle tracker. How the models work →
| Field | Type | Description |
|---|---|---|
data.attacker / defender | object | The two cars in the on-track fight (each a full DriverRef: number, driverId, tla, name, team). |
data.currentGapSec | number | Current gap between the pair (seconds). |
data.catchRateSecPerLap | number | Positive = attacker closing; negative = defender pulling away. |
data.lapsToStrikingDistance | number|null | Projected laps until the attacker is in range; null when not catching or already there. |
data.battleStatus | string | Lifecycle of the battle (forming, in-range, resolved…). |
analytics.pit-windowPit Window Alertanalytics
Pit-window status (OPEN / URGENT) combining pit probability, undercut viability, tyre cliff risk, and gap context.
Backed by: pit window alert, pit stop probability, EKF tire health. How the models work →
| Field | Type | Description |
|---|---|---|
data.driver | object | The driver the alert is for (full DriverRef: number, driverId, tla, name, team). |
data.status | string | Pit-window state for the driver (survival-model window plus overrides). |
data.pitProbability | number | 0–1 pit-stop probability from the pit stop model. |
data.undercutViable | boolean | Whether an undercut on the car ahead is currently viable. |
data.cliffRisk | string | Tyre-cliff proximity classification feeding the window call. |
data.overrideReason | string|null | "VSC_WINDOW" | "SC_WINDOW" | "LEADER_PITTED" — event overrides that open a window early. |
data.vscNetDeltaSec | number|null | Estimated time saved by pitting under the current VSC/SC, when applicable. |
data.pitCount | number | The driver's current pit-stop count. |
analytics.track-conditionsTrack Conditions Analyticsanalytics
Track evolution and grip-condition analytics derived from field pace trends.
Backed by: track conditions model. How the models work →
| Field | Type | Description |
|---|---|---|
data.sector1 / sector2 / sector3 | string | Per-sector surface condition classification. |
data.fullCircuitWet | boolean | All three sectors classified wet. |
data.intermediateWindowOpen | boolean | Any sector wet AND slick runners losing more than ~2s — the inter window. |
data.crossoverRecommended | boolean | Slick cars now faster than intermediates in at least one sector — the crossover call. |
data.lastUpdatedLap | number | Race lap this classification was last updated. |
analytics.pit-qualityPit Quality Alertanalytics
Pit-stop execution quality assessment (stationary time vs. expected) after a stop completes.
Backed by: pit quality model. How the models work →
| Field | Type | Description |
|---|---|---|
data.driver | object | The driver whose stop this grades (full DriverRef: number, driverId, tla, name, team). |
data.stationaryTimeSec | number | Measured stationary time for the completed stop. |
data.teamSessionAverageSec | number | The team's rolling average stationary time this session (before this stop). |
data.vsTeamSessionAverageSec | number | This stop minus the team average — positive = slower than the crew's norm. |
data.quality | string | Grade for the stop relative to session norms. |
data.stopNumber | number | Nth stop this session for this driver. |