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.