f1-racing-agent

Real-time Formula 1 racing data - schedules, standings, drivers, circuits, and race results. Powered by live F1 data.

  • 6 Entrypoints
  • v1.0.0 Version
  • Enabled Payments
f1-racing-agent-production.up.railway.app
View Manifest List Entrypoints

Entrypoints

Explore the capabilities exposed by this agent. Invoke with JSON, stream responses when available, and inspect pricing where monetization applies.

overview

Invoke

Free overview of F1 season - top 3 drivers and constructors standings, plus next race

Pricing Free
Network base
Invoke Endpoint POST /entrypoints/overview/invoke
Invoke
Input Schema 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
Invoke with curl 
curl -s -X POST \
  'https://f1-racing-agent-production.up.railway.app/entrypoints/overview/invoke' \
  -H 'Content-Type: application/json' \
  -d '
    {
      "input": {}
    }
  '

driver

Invoke

Look up a specific F1 driver by ID (e.g., max_verstappen, norris, hamilton)

Pricing Free
Network base
Invoke Endpoint POST /entrypoints/driver/invoke
Invoke
Input Schema 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "driverId": {
      "type": "string",
      "description": "Driver ID (e.g., max_verstappen, norris, hamilton, leclerc)"
    }
  },
  "required": [
    "driverId"
  ],
  "additionalProperties": false
}
Invoke with curl 
curl -s -X POST \
  'https://f1-racing-agent-production.up.railway.app/entrypoints/driver/invoke' \
  -H 'Content-Type: application/json' \
  -d '
    {
      "input": {
        "driverId": "<Driver ID (e.g., max_verstappen, norris, hamilton, leclerc)>"
      }
    }
  '

standings

Invoke

Full driver and constructor standings for specified season

Pricing Free
Network base
Invoke Endpoint POST /entrypoints/standings/invoke
Invoke
Input Schema 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "season": {
      "default": "2025",
      "type": "string"
    },
    "type": {
      "default": "both",
      "type": "string",
      "enum": [
        "drivers",
        "constructors",
        "both"
      ]
    }
  },
  "required": [
    "season",
    "type"
  ],
  "additionalProperties": false
}
Invoke with curl 
curl -s -X POST \
  'https://f1-racing-agent-production.up.railway.app/entrypoints/standings/invoke' \
  -H 'Content-Type: application/json' \
  -d '
    {
      "input": {
        "season": "string",
        "type": "drivers"
      }
    }
  '

schedule

Invoke

F1 race schedule with dates, circuits, and session times

Pricing Free
Network base
Invoke Endpoint POST /entrypoints/schedule/invoke
Invoke
Input Schema 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "season": {
      "default": "current",
      "type": "string"
    },
    "upcoming": {
      "default": false,
      "type": "boolean"
    }
  },
  "required": [
    "season",
    "upcoming"
  ],
  "additionalProperties": false
}
Invoke with curl 
curl -s -X POST \
  'https://f1-racing-agent-production.up.railway.app/entrypoints/schedule/invoke' \
  -H 'Content-Type: application/json' \
  -d '
    {
      "input": {
        "season": "string",
        "upcoming": true
      }
    }
  '

results

Invoke

Detailed race results with positions, times, and lap data

Pricing Free
Network base
Invoke Endpoint POST /entrypoints/results/invoke
Invoke
Input Schema 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "season": {
      "default": "2025",
      "type": "string"
    },
    "round": {
      "default": "last",
      "type": "string"
    }
  },
  "required": [
    "season",
    "round"
  ],
  "additionalProperties": false
}
Invoke with curl 
curl -s -X POST \
  'https://f1-racing-agent-production.up.railway.app/entrypoints/results/invoke' \
  -H 'Content-Type: application/json' \
  -d '
    {
      "input": {
        "season": "string",
        "round": "string"
      }
    }
  '

report

Invoke

Comprehensive F1 report - standings, upcoming races, and recent results

Pricing Free
Network base
Invoke Endpoint POST /entrypoints/report/invoke
Invoke
Input Schema 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
Invoke with curl 
curl -s -X POST \
  'https://f1-racing-agent-production.up.railway.app/entrypoints/report/invoke' \
  -H 'Content-Type: application/json' \
  -d '
    {
      "input": {}
    }
  '

Client Example: x402-fetch

Use the x402-fetch helpers to wrap a standard fetch call and automatically attach payments. This script loads configuration from .env, pays the facilitator, and logs both the response body and the decoded payment receipt. 

import { config } from "dotenv";
import {
  decodeXPaymentResponse,
  wrapFetchWithPayment,
  createSigner,
  type Hex,
} from "x402-fetch";

config();

const privateKey = process.env.AGENT_WALLET_PRIVATE_KEY as Hex | string;
const agentUrl = process.env.AGENT_URL as string; // e.g. https://agent.example.com
const endpointPath = process.env.ENDPOINT_PATH as string; // e.g. /entrypoints/echo/invoke
const url = `${agentUrl}${endpointPath}`;

if (!agentUrl || !privateKey || !endpointPath) {
  console.error("Missing required environment variables");
  console.error("Required: AGENT_WALLET_PRIVATE_KEY, AGENT_URL, ENDPOINT_PATH");
  process.exit(1);
}

/**
 * Demonstrates paying for a protected resource using x402-fetch.
 *
 * Required environment variables:
 * - AGENT_WALLET_PRIVATE_KEY    Wallet private key for signing payments
 * - AGENT_URL                   Base URL of the agent server
 * - ENDPOINT_PATH               Endpoint path (e.g. /entrypoints/echo/invoke)
 */
async function main(): Promise<void> {
  // const signer = await createSigner("solana-devnet", privateKey); // uncomment for Solana
  const signer = await createSigner("base-sepolia", privateKey);
  const fetchWithPayment = wrapFetchWithPayment(fetch, signer);

  const response = await fetchWithPayment(url, { method: "GET" });
  const body = await response.json();
  console.log(body);

  const paymentResponse = decodeXPaymentResponse(
    response.headers.get("x-payment-response")!
  );
  console.log(paymentResponse);
}

main().catch((error) => {
  console.error(error?.response?.data?.error ?? error);
  process.exit(1);
});

Manifest

Loading… 
Fetching agent card…