API Overview

Real-time sports data API covering 30+ sports & esports with 1,000+ betting markets per event. Built for low-latency live odds, settlement, and quantitative analysis.

Get 35% More Requests — Same Price. Our direct plans at fieldfunded.com offer 35% higher quotas per plan compared to RapidAPI, plus an exclusive Mega plan ($299/mo — 10M req/mo, 120 req/s) not available here. Acess fieldfunded.com for a direct API key.

TypeScript SDK (Zero Dependencies)

Official zero-dependency SDK with 100% Type-Safety and automatic retries. Works in Node.js 18+, Deno, Bun, and all modern browsers:

npm install @fieldfunded/sdk

import { FieldFundedSDK } from '@fieldfunded/sdk';

const client = new FieldFundedSDK({ apiKey: 'YOUR_RAPIDAPI_KEY' });

const live = await client.getLive();
const detail = await client.getEvent(live.events[0].id);
console.log(detail.markets.length); // 1,000+ markets

What You Get

Every plan — including Free — includes every sport, every market, and every feature. You only pay for request volume.

Live & Pre-Match Odds — Refreshed every 300ms with 1,000+ markets per event including player props and handicaps
Fixtures & Live Scores — Upcoming schedules and live scores with cards, corners, periods, match timers and more
30+ Sports & Esports — Soccer, Basketball, Tennis, Ice Hockey, Baseball, American Football, MMA, CS2, LoL and more
Automatic Settlement — Markets resolve automatically after game end (won/lost/refund), no developer action needed, with optional stake and payout calculation
Parlay Resolution — Submit single or multi-leg bets and get combined result with payout calculation, refund legs treated as odds 1.00
Outrights & Futures — Long-term season markets like League Winner, Top Goalscorer, Most Assists and Tournament MVP
Featured Games — Curated top matches from Premier League, Champions League, NBA, NFL and more, sorted live-first
Logos, Flags & Icons — PNG and SVG team logos, league logos, 182 SVG country flags and custom sport icons
Game Results Archive — Permanent final score snapshots for ended events, available even after live data expires

Available Endpoints (25 total)

Odds & Events

GET /v1/events — Live and pre-match events with full odds and scores
GET /v1/events/{eventId} — Full event detail with all markets
GET /v1/events/{eventId}/odds — Odds-only for a specific event
GET /v1/events/batch — Batch fetch multiple events by ID
GET /v1/live — All live events
GET /v1/featured — Curated top matches from priority leagues
GET /v1/scores — Lightweight live scores without market data
GET /v1/search — Search events by team or league name

Discovery

GET /v1/sports — List all available sports with IDs
GET /v1/leagues — List all leagues for a sport
GET /v1/markets — List available market types for a sport

Scores & Results

GET /v1/events/{eventId}/result — Final score and match result

Settlement & Bet Resolution

GET /v1/settlements — Settlement feed with per-market resolution (won/lost/refund)
GET /v1/settlements/outrights — Outright/futures market settlements
POST /v1/bets/check — Single bet resolution against settlement data
POST /v1/bets/check-parlay — Multi-leg parlay resolution with combined payout

Outrights & Futures

GET /v1/outrights — Active outright/futures markets
GET /v1/outrights/sports — Sports with active outrights
GET /v1/outrights/{tournamentId} — Full odds for a specific tournament

Visual Assets

GET /v1/logos/team — Team logos (PNG and SVG)
GET /v1/logos/league — League logos (SVG)
GET /v1/logos/country — Country flags (182 SVG)
GET /v1/logos/sport — Sport icons (SVG)

Usage & System

GET /v1/usage — Current quota usage
GET /v1/usage/endpoints — Per-endpoint usage breakdown
GET /v1/usage/warnings — Quota warning thresholds
GET /v1/ping — Health check
GET /v1/health — Detailed health status
GET /v1/status — System and usage status

FAQ

Do all plans include all sports and markets?
Yes. Every plan — including Free — includes all 30+ sports, all 1,000+ markets per event on major leagues and every feature. You only pay for request volume.

How often are odds updated?
Odds are refreshed every 300ms from live feeds for both live and pre-match events.

How does automatic settlement work?
Markets resolve automatically after game end (won/lost/refund) — no developer action needed, including player props. Send optional stake to get instant payout calculation.

How are refund legs handled in parlays?
Refund legs are treated as odds 1.00 in the combined calculation. They remain in the parlay but do not affect the combined odds.

What visual assets are included?
PNG team logos (~85% coverage), PNG and SVG team logos for featured leagues, SVG league logos, 182 SVG country flags and custom SVG sport icons. All included on every plan.

How long are game results available?
Final scores are permanently archived and available via the results endpoint after the game ends.

Do you support esports?
Yes. CS2, Dota 2, LoL, Valorant, Rainbow Six, King of Glory, Call of Duty and Mobile Legends.

What odds format is used?
All odds are returned in Decimal (European) format by default. Use the odds_format parameter to convert to American or Fractional.

Need higher quotas?
Our direct plans at api.fieldfunded.com/docs offer up to 35% more requests for the same price. Contact support@fieldfunded.com.