# RacingPulse

> Global horse racing intelligence API — real-time odds, going conditions, form analysis, arbitrage detection, speed ratings, and betting systems for 35 racecourses across 8 countries. Powered by Claude AI + x402 micropayments on Base.

## What This Is

RacingPulse is a pay-per-query API delivering structured horse racing intelligence. Every response synthesizes live bookmaker odds, real-time weather-derived going conditions, web-sourced form data, and statistical trends via Claude AI.

Coverage: UK, Ireland, Australia, Hong Kong, Japan, France, USA — 35 named racecourses, live bookmaker odds from 40+ bookmakers via The Odds API.

## Payment

All endpoints require x402 micropayment (USDC on Base mainnet).
Protocol: x402 | Network: eip155:8453 | Asset: USDC
Price: $0.07 per query

To use: send a GET request without a PAYMENT-SIGNATURE header to receive a 402 response with payment requirements. Sign the payment and retry with the PAYMENT-SIGNATURE header.

## Endpoints

GET /api/scanner
- Returns: live arbitrage scan across all active horse racing sports — guaranteed-profit opportunities detected by comparing odds across 40+ bookmakers
- Price: $0.07

GET /api/arbitrage?sport={horse_racing_uk|horse_racing_au|horse_racing_us}&min_profit={0.5}
- Returns: filtered arbitrage opportunities for a specific racing jurisdiction, with per-runner stake allocations
- Price: $0.07

GET /api/card?track={ascot|cheltenham|flemington|...}&date={YYYY-MM-DD}
- Returns: complete race card briefing — runners, odds, going conditions, meeting news and key trends
- Price: $0.07

GET /api/going?track={ascot|all}
- Returns: live going conditions derived from Open-Meteo 7-day precipitation data — UK/IE scale (Firm→Heavy) or AU/US/HK/JP scale
- Track "all" returns summary for top 12 tracks simultaneously
- Price: $0.07

GET /api/form?horse={name}&trainer={name}
- Returns: deep horse form analysis — recent runs, going preferences, distance patterns, trainer stats, strengths and concerns
- Price: $0.07

GET /api/ratings?horse={name}
- Returns: official rating, RPR, Timeform rating, going-adjusted ratings, distance performance breakdown
- Price: $0.07

GET /api/systems?filter={description}
- Returns: statistically-backed betting systems and angles — strike rates, ROI, trainer/jockey combos, draw bias
- Examples: "Ascot sprints", "novice hurdlers", "flat handicaps"
- Price: $0.07

GET /api/trends?race={name}
- Returns: historical race trends — draw bias, age profile, weight trends, trainer records, value and fade angles
- Price: $0.07

GET /api/track?track={name}
- Returns: complete racecourse profile — shape, bias, draw statistics, optimal running styles, current going conditions
- Price: $0.07

GET /api/calculator?mode={arb|ev}&...
- Returns: arbitrage stake calculations (Kelly-weighted) or expected value analysis
- Arb mode params: bankroll, odds (comma-separated runner odds)
- EV mode params: single_odds, true_prob, stake
- Price: $0.07

## Available Tracks

UK: cheltenham, ascot, newmarket, sandown, goodwood, epsom, york, chester, kempton, haydock, lingfield, doncaster, leicester, windsor
Ireland: leopardstown, curragh, fairyhouse, punchestown, galway
Australia: flemington, randwick, rosehill, caulfield, moonee-valley
Hong Kong: sha-tin, happy-valley
Japan: tokyo, kyoto, hanshin, nakayama
France: longchamp, chantilly, deauville
USA: belmont, churchill-downs, santa-anita, keeneland, saratoga, gulfstream

## Discovery

- OpenAPI spec: https://racingpulse.vercel.app/openapi.json
- Agent discovery: https://racingpulse.vercel.app/.well-known/agent.json

## Notes for AI Agents

- All endpoints return structured JSON
- Going conditions require no API key (Open-Meteo is free)
- Odds data requires ODDS_API_KEY (The Odds API — 500 free requests/month)
- Form/trends/systems require TAVILY_API_KEY (Tavily — 1,000 free searches/month)
- Form and ratings are AI-synthesized from web data — not from an official racing database
- Arbitrage windows typically close within 30-90 seconds — verify before acting