Feeds
Get Feed Catalog
List all subscribable motorsport timing feeds. Use the feedId when creating a webhook subscription.
Free tier feeds:
- session.status — Session lifecycle: Started, Aborted, Finished, Finalised, Ends.
- session.track-status — Track flag code: 1=Clear, 2=Yellow, 4=SC, 5=Red, 6=VSC, 7=VSC Ending.
- weather.data — Air/track temp, humidity, pressure, wind, rainfall.
- session.lap-count — Current lap and total laps remaining.
- driver.list — Driver number, TLA, full name, team name, team colour.
Developer feeds (live):
- timing.data — Per-driver position, gaps (leader + interval), lap/sector times, speed traps, pit status.
- timing.stats — Personal best lap, best sectors, speed trap rankings.
- timing.lap-history — Accumulated per-driver lap data series.
- timing.driver-info — Per-driver position, gap, interval, pit stops, overtake state.
- tire.current — Current compound per driver with age and new-set flag.
- tire.history — Full stint history: compound, start lap, laps on tyre.
- tire.stints — Each driver's complete stint list: compound, new set, tyre age, laps, best lap; plus grid slot.
- pit.lane-times — Pit stop durations in milliseconds with pit-in/out laps.
- pit.stops — Official F1 single pit-stop record (authoritative, arrives after the live stop).
- pit.stop-series — Full pit-stop history per driver.
- session.clock — Session countdown clock with remaining time and extrapolating flag.
- weather.data-series — Time-series history of weather data.
- race-control.messages — Raw FIA race control messages: safety car, VSC, red flag, penalties, investigations.
- regulatory.stewards-decision — Parsed FIA stewards decisions: penalty type, driver, session, infringement, grid places / seconds / fine, raw decision text.
- race.grid-penalty — Grid-affecting stewards decisions only (grid drop, back of grid, pit-lane start), with the number of grid places.
- session.info — Session metadata: circuit, event, type, start/end dates, GMT offset.
- telemetry.driver-tracker — Low-resolution live position (x/y/z).
- telemetry.track-position — Every car's live position on the circuit — lap fraction plus x/y track coordinates — reconstructed each second from timing.
- timing.top-three — Simplified live leaderboard for the top three cars — position, driver, lap time, and gap. Zero-dependency feed for tickers and score overlays.
- events.race — RaceHooks-computed synthetic events: overtakes, pit stops, safety cars, fastest laps, retirements, penalties, and more (40+ event types).
- session.timing — Aggregated session timing state: flag, lap, clock, qualifying segment, resume time.
- events.qualifying — Qualifying-specific synthetic events: lap improvements, eliminations, pole position, front row, session complete.
- fantasy.scores — Provisional fantasy points per driver with the full component breakdown, pushed when a score changes. Same computation as the fantasy REST routes.
- weather.rain-onset — Fires when rainfall begins at the circuit.
- weather.rain-cleared — Fires when rainfall stops at the circuit.
Analytics feeds (Custom tier):
- radio.transcript — Team radio speech, transcribed: what the driver and pit wall actually said, with a confidence score.
- standings.projection — Live championship points simulation: projected standings if the current race order holds.
- results.classification — Post-race classified positions (fires once after race end).
- timing.mini-sectors — High-granularity timing companion: mini-sector progress ticks, speed-trap readings (I1, I2, FL, ST), and live pit/retirement flags.
- results.race-summary — Post-race telemetry summary with aggregate metrics and links to full telemetry endpoints.
- analytics.strategy — 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)).
- strategy.recommendation — Prescriptive counterfactual strategy ranking for the front-runners: candidate pit-and-compound schedules simulated under common random numbers and ranked by outcome distribution — P(win), P(podium), expected finish, expected championship points, p10–p90 robustness spread — with the emergent-strategy baseline for honest comparison.
- analytics.race-odds — Monte Carlo 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.
- analytics.true-pace — 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.
- analytics.gap-projection — Projected gap to the race leader at race end for every driver: five percentile bands (p10–p90) plus P(lapped) from Monte Carlo simulation.
- analytics.winning-margin — 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.
- analytics.race-preview — 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).
- analytics.race-duration — Projected total race time with p10/p90 bands, expected winner lap time, red-flag probability, and P(race exceeds the 2-hour FIA limit).
- analytics.tire-strategy — 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.
- analytics.team-points — Constructor-level expected points from discrete joint position-distribution convolution, with P(both drivers score) and full points distribution.
- analytics.championship-probability — Post-race championship win probability for every driver (WDC) and constructor (WCC). afterRaceId identifies which race the data reflects.
- analytics.qualifying — Per-sector fastest probabilities and per-driver pace deltas during qualifying, with pole-margin probability. Fires after each personal best.
- analytics.sector-pace — Per-sector pace deltas with anomaly detection; fires when a sector-pace anomaly is detected.
- analytics.battle — On-track battle status between a driver and the car directly ahead (closing, holding, defending).
- analytics.pit-window — Pit-window status (OPEN / URGENT) combining pit probability, undercut viability, tyre cliff risk, and gap context.
- analytics.track-conditions — Track evolution and grip-condition analytics derived from field pace trends.
- analytics.pit-quality — Pit-stop execution quality assessment (stationary time vs. expected) after a stop completes.
- weather.strategy-divergence — Fires during active rain when the field splits between wet and dry compound strategies.
- weather.compound-crossover — Fires when forecast conditions cross the threshold where a different compound becomes optimal.
- weather.forecast-update — Fires when precipitation forecast changes by more than 0.5 mm/hr.
- weather.tire-mismatch — Per-driver alert when a car is on slicks with rain falling or imminent — the wrong tyre for the conditions.
get/v1/feeds
Request
- Base URL: https://api.racehooks.io
- URL: https://api.racehooks.io/v1/feeds
- Auth: none declared
Query parameters
limitinteger
offsetinteger
Response
Feed catalog
Changes
No recorded changes to this operation across all 1 revision of this API.