Using FormFav with AI Agents

https://api.formfav.com/v1/openapi.json

You have access to the FormFav horse racing API.

Base URL: https://api.formfav.com/v1
Auth: X-API-Key header (key is in the FORMFAV_API_KEY environment variable)

Key endpoints:
- GET /form/meetings?date=YYYY-MM-DD&race_code=gallops  — list race meetings for a date
- GET /form?date=YYYY-MM-DD&track=SLUG&race=N  — full race form with runners and stats
- GET /predictions?date=YYYY-MM-DD&track=SLUG&race=N  — win/place probabilities (Pro tier)
- GET /stats/jockey/{name}  — jockey performance statistics (Pro tier)
- GET /stats/trainer/{name}  — trainer performance statistics (Pro tier)
- GET /stats/track-bias/{track}  — barrier bias analysis, per distance band or scoped with ?distance=1200 / ?distance=1200-1600 (Pro tier)
- GET /stats/runner/{name}  — runner career stats and form analysis (Pro tier)
- GET /form/venues  — look up track names and slugs

Parameters:
- date: YYYY-MM-DD format (default timezone: Australian Eastern time, configurable via timezone param)
- track: lowercase slug (e.g. "randwick", "flemington") — use /form/venues to look up
- race_code: "gallops" (default), "harness", or "greyhounds"
- country: "au" (default), "nz", "hk", "gb", "us", "eu"
- timezone: IANA timezone (e.g. "Australia/Sydney") for date interpretation

import os
import requests
from datetime import date

API_KEY = os.environ["FORMFAV_API_KEY"]
BASE = "https://api.formfav.com/v1"
HEADERS = {"X-API-Key": API_KEY}

def get(endpoint, params=None):
    """Make a GET request with retry on rate limit."""
    resp = requests.get(f"{BASE}{endpoint}", headers=HEADERS, params=params)
    if resp.status_code == 429:
        wait = int(resp.headers.get("Retry-After", 60))
        print(f"Rate limited — waiting {wait}s")
        import time; time.sleep(wait)
        resp = requests.get(f"{BASE}{endpoint}", headers=HEADERS, params=params)
    resp.raise_for_status()
    return resp.json()

# 1. Get today's meetings
today = date.today().isoformat()
meetings = get("/form/meetings", {"date": today, "race_code": "gallops"})

if not meetings.get("meetings"):
    print("No gallops meetings today")
    exit()

# 2. Pick the first meeting
track = meetings["meetings"][0]["slug"]
print(f"Fetching Race 1 at {track} on {today}")

# 3. Get race form
card = get("/form", {"date": today, "track": track, "race": 1})

# 4. Print runner summary
for runner in card.get("runners", []):
    name = runner.get("name", "Unknown")
    jockey = runner.get("jockey", "—")
    form = runner.get("last10Starts", "—")
    print(f"  {runner.get('number', '?')}. {name} (J: {jockey}) — Form: {form}")

const API_KEY = process.env.FORMFAV_API_KEY;
const BASE = "https://api.formfav.com/v1";

async function get(endpoint, params = {}) {
  const url = new URL(BASE + endpoint);
  Object.entries(params).forEach(([k, v]) => url.searchParams.set(k, v));
  const resp = await fetch(url, { headers: { "X-API-Key": API_KEY } });
  if (!resp.ok) throw new Error(`${resp.status} ${resp.statusText}`);
  return resp.json();
}

// 1. Get today's meetings
const today = new Date().toISOString().slice(0, 10);
const meetings = await get("/form/meetings", { date: today, race_code: "gallops" });

if (!meetings.meetings?.length) {
  console.log("No gallops meetings today");
  process.exit();
}

// 2. Pick the first meeting and fetch race 1
const track = meetings.meetings[0].slug;
console.log(`Fetching Race 1 at ${track} on ${today}`);

const card = await get("/form", { date: today, track, race: "1" });

// 3. Print runner summary
for (const r of card.runners ?? []) {
  console.log(`  ${r.number}. ${r.name} (J: ${r.jockey}) — Form: ${r.last10Starts ?? "—"}`);
}