V4 Odds API Overview

Pre-match and in-play odds comparison from 100+ bookmakers across 17 sports

V4 Odds API

The V4 API is SportsAPI Pro’s dedicated odds comparison layer. It returns pre-match and in-play prices from 100+ bookmakers, plus the surrounding context you need to build a full betting product: league standings, top scorers, outright/futures markets, community polls, top tipsters, bookmaker payouts, special offers, and a 570+ article betting-news feed.

Key Features

• 100+ bookmakers with full odds, line movements, and best-odds (/odds/max) feeds
• 17 sports including football, tennis, basketball, ice hockey, baseball, cricket, MMA, darts, table tennis, handball, American football, volleyball, plus special bets and novelty markets
• Pre-match and in-play prices in the same payload (prematch / inplay arrays)
• Odds movements — historical open / high / low per bookmaker and average
• League depth — standings, top scorers, outright markets, league-level special offers
• Team depth — venue, manager, league memberships, upcoming + finished matches, team-targeted bookmaker offers
• Community signals — match polls, community win-probability predictions, top tipster rankings
• News feed — paginated betting news / blog posts with thumbnails and tags
• World Cup 2026 convenience endpoints (see World Cup 2026)
• Stale-cache fallback — last-known data is served if the upstream is momentarily unavailable, so your UI never goes blank

Base URL Pattern

https://v4.{sport}.sportsapipro.com

Examples:

• https://v4.football.sportsapipro.com
• https://v4.tennis.sportsapipro.com
• https://v4.basketball.sportsapipro.com

All sports also resolve from the football vanity host, e.g. https://v4.football.sportsapipro.com/api/v1/tennis/today works. Use whichever subdomain matches the primary sport on the calling page.

Every V4 sport resolves from any V4 vanity host — v4.tennis.sportsapipro.com/api/v1/football/today works exactly the same as the football host. The subdomain is for grouping and analytics; it does not restrict the data you can query.

Authentication

Every request requires your API key:

curl -H "x-api-key: YOUR_API_KEY" \
  https://v4.football.sportsapipro.com/api/v1/football/today

The only unauthenticated endpoint is /health.

Quick Start

JavaScript

const res = await fetch(
  'https://v4.football.sportsapipro.com/api/v1/football/today',
  { headers: { 'x-api-key': 'YOUR_API_KEY' } }
);
const { matches } = await res.json();
matches.forEach(m => {
  console.log(`${m.homeTeam} vs ${m.awayTeam} — ${m.matchDate}`);
});

Response Shape

Every JSON payload includes a generatedAt timestamp marking when the upstream snapshot was taken. Match kickoff times are ISO 8601 with timezone (e.g. 2026-06-11 19:00:00+00).

Sports Reference

ID	Slug	Name
1	football	Football
2	ice-hockey	Ice Hockey
3	basketball	Basketball
5	tennis	Tennis
6	american-football	American Football
7	baseball	Baseball
8	handball	Handball
13	volleyball	Volleyball
14	cricket	Cricket
15	table-tennis	Table Tennis
18	mixed-martial-arts	MMA
20	darts	Darts
66	special-bets	Special Bets
76	politics	Politics
77	tv	TV
78	novelty	Novelty
79	awards	Awards

Use the slug value for ?sport= and shorthand paths. The numeric ID is used in match/team/league responses for cross-referencing.

Common Workflows

1. Today’s matches with best odds — /api/v1/football/today → for each match /api/v1/match/{id}/odds.
2. League page — /api/v1/leagues?sport=football&topOnly=1 → /api/v1/league/{id}/standings → /api/v1/league/{id}/top-scorers.
3. Match page — /api/v1/match/{id} (info) + /odds + /odds-movements + /prediction.
4. Team page — /api/v1/team/{id} + /api/v1/team/{id}/matches + /api/v1/team/{id}/offers.
5. Bookmaker rankings — /api/v1/bookmakers + /api/v1/bookmakers/payouts?sport=football&market=100.
6. World Cup hub — see World Cup 2026.

Related Pages

• All Endpoints — full catalog with cache TTLs
• Caching — per-endpoint TTL reference
• Errors — status codes and recovery behavior