Install Jentic One Beta

Connect the OpenF1 API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the OpenF1 API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fopenf1.org%2Fopenf1" | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fopenf1.org%2Fopenf1" | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with OpenF1 API.

Stream car telemetry samples (speed, RPM, gear, throttle, brake) via /car_data with session and driver filters

Retrieve lap times and lap-by-lap data through /laps for any session and driver

Track gaps between cars during a session via /intervals at high refresh

Pull pit-stop events from /pit and stint information from /stints to reconstruct race strategy

GET STARTED

Start building with OpenF1 API

Explore with Jentic One

View OpenAPI Document

Use Cases

Patterns agents use OpenF1 API for, with concrete tasks.

★ Race-Day Companion App

Build a second-screen race companion app that shows live laps, intervals, pit stops, and race-control messages while a Formula 1 session is underway. OpenF1 streams the data through query-filtered REST endpoints; the app polls /laps and /intervals every few seconds and renders a live timing tower without negotiating a commercial timing-data licence.

Call /laps?session_key=9999&driver_number=44 and return the most recent lap time and sector breakdown for the driver.

Strategy Reconstruction

Reconstruct a team's race strategy from /pit, /stints, /laps, and /race_control. Useful for analyst content ("what if Mercedes had pitted on lap 18?") and for engineering students learning tyre and stint modelling. Historical sessions are indexed with stable session_key and meeting_key values so notebooks can be re-run reliably.

For session_key 9472, fetch /stints and group by driver_number to list compound and lap span for each stint.

Telemetry Visualisation

Visualise raw telemetry - throttle, brake, RPM, speed, gear - via /car_data filtered by session and driver. Used by content creators and engineering tutorials to overlay driver inputs through a single corner. Sample rates are high enough for frame-by-frame charts without ingesting full broadcast feeds.

Call /car_data?session_key=9472&driver_number=1 with a date filter for one minute around lap 12 and chart speed over time.

Agent-Driven F1 Q&A

An AI agent answering Formula 1 questions can use Jentic to discover the right OpenF1 endpoint for a query like "what was Verstappen's fastest lap in Bahrain 2024?". Jentic returns /laps with the input schema; the agent chooses the session_key and driver_number, sorts the response by lap_duration, and returns the answer grounded in the API.

Through Jentic, find the operation for "laps in a session" and call it with the resolved session_key and driver_number, returning the minimum lap_duration.

Key Endpoints

13 endpoints — openf1 is a free rest api that exposes real-time and historical formula 1 data including car telemetry, driver and team metadata, lap times, intervals, pit stops, race-control messages, sessions, stints, team radio, and weather.

METHOD

PATH

DESCRIPTION

GET

/sessions

List F1 sessions filtered by meeting, year, or type

GET

/meetings

List Grand Prix weekends

GET

/drivers

List drivers participating in a session

GET

/laps

Get lap times and sector data

GET

/intervals

Gaps between cars during a session

GET

/pit

Pit-stop events

GET

/car_data

Per-car telemetry samples

GET

/race_control

Race-control messages

GET

/sessions

List F1 sessions filtered by meeting, year, or type

GET

/meetings

List Grand Prix weekends

GET

/drivers

List drivers participating in a session

GET

/laps

Get lap times and sector data

GET

/intervals

Gaps between cars during a session

GET

/pit

Pit-stop events

GET

/car_data

Per-car telemetry samples

GET

/race_control

Race-control messages

Why Jentic?

What agents get from Jentic-routed access to this vendor.

Setup

Wiring the OpenF1 API by hand means shaping the session, timing, and telemetry queries with their session_key and driver_number filters and parsing the responses yourself, even though no credentials are involved. Through Jentic you install once, import the OpenF1 API from the API Directory, and your agent calls it directly.

Permission scoping

OpenF1 is a read-only telemetry API with no credentials whose filters travel in the request parameters, so scope it by limiting the agent to the operations it needs, such as lap times, pit stops, or car data. You choose the operations it may call, and nothing beyond that set runs.

Credential isolation

OpenF1 is unauthenticated, so there is nothing to store; your Jentic One instance still routes the call through its execution layer. No secret ever enters the agent's prompt, logs, or context.

Intent-based discovery

Agents search Jentic by intent such as 'lap times in an F1 session' or 'pit stops in a Grand Prix', and Jentic returns the matching OpenF1 operation with its session_key and driver_number schema so the agent calls the right endpoint without browsing the reference docs.

FAQs

Specific to using OpenF1 API through Jentic.

What authentication does the OpenF1 API use?

OpenF1 is fully unauthenticated - no API key, OAuth token, or signed request is required. Jentic still routes the request through your Jentic One instance so observability and retry behaviour match authenticated APIs and the integration is forward-compatible if OpenF1 adds keys later.

Can I get live timing data with the OpenF1 API?

Yes. /intervals and /laps return data within a few seconds of the live broadcast feed during sessions, and /position tracks running order in real time. Poll with the session_key for the active session and a date filter for the most recent samples.

What are the rate limits for the OpenF1 API?

OpenF1 publishes guidance to be reasonable with polling - there is no hard documented limit but heavy real-time consumers should aggregate filters (session_key plus a tight date range) rather than scanning the dataset, and back off on HTTP 429 if returned.

How do I find the session_key for a specific Grand Prix through Jentic?

Use the Jentic search query "list F1 sessions for a Grand Prix". Jentic returns /sessions with its query schema; the agent supplies meeting_key (resolved from /meetings by year and country) and reads the resulting session_key values. Run it through Jentic One, the self-hosted execution layer.

Is the OpenF1 API free to use?

Yes. OpenF1 is a free public service. The project accepts donations but does not charge for API access at any tier.

Can the OpenF1 API stream telemetry as WebSocket?

No. OpenF1 is REST-only - clients poll the relevant endpoint with a date filter to get recent samples. For low-latency consumers, narrow the time window and increase polling frequency rather than expecting a push channel.

Can I limit what my agent is allowed to do with the OpenF1 API?

Yes. Because you run Jentic One yourself, your own rules decide which OpenF1 operations the agent may call, so you can allow only the reads it needs, such as /laps for lap times, /pit for pit stops, or /car_data for telemetry, and nothing beyond that set runs. OpenF1 is read-only with no credentials and its filters travel in the request parameters, so scoping is a matter of picking the exact operations you grant. If a task only needs timing data, the agent never gets the ability to pull car telemetry or race-control messages.

OpenF1 API

Name: OpenF1 API
Brand: OpenF1 API
Availability: InStock

Official vendor OpenAPI document · agent-readyData EnrichmentData Transformationnone13 EndpointsREST

For Agents

Pull live and historical Formula 1 telemetry, lap times, pit stops, race-control messages, and weather across 13 endpoints from a free public REST API.

Use for: Get all sessions for a specific Formula 1 Grand Prix weekend, Retrieve lap times for a driver in a given race session, List pit stops for every driver in the Monaco Grand Prix, Find the gap between two drivers at lap 30

Not supported: Does not handle live video, official results certification, or fantasy-league management - use for read-only Formula 1 telemetry, timing, and contextual race data only.

OpenF1 is a free REST API that exposes real-time and historical Formula 1 data including car telemetry, driver and team metadata, lap times, intervals, pit stops, race-control messages, sessions, stints, team radio, and weather. It is widely used by Formula 1 fan apps, second-screen experiences, race-strategy simulators, and analytics dashboards that need timing and telemetry without the cost of a commercial provider. All thirteen endpoints accept rich query filtering and return JSON.

Jentic One on Github View OpenAPI Document