V4 Odds API Overview

​

V4 Odds API

​

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://api.sportsapipro.com/v4/{sport}

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

​

Authentication

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

​

Quick Start

const res = await fetch(
  'https://api.sportsapipro.com/v4/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}`);
});

import requests

r = requests.get(
    'https://api.sportsapipro.com/v4/football/match/9798283/odds',
    headers={'x-api-key': 'YOUR_API_KEY'},
)
data = r.json()
for group in data['prematch']:
    print(group['og_name'])

curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.sportsapipro.com/v4/football/league/627/standings"

​

Response Shape

​

Sports Reference

​

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