Skip to main content
Version: 2.0.0

Leagues & Sport API Documentation

Description

This endpoint returns all the available leagues that are active in a given sport, ie: NFL, NBA, MLB, NHL, Premier League, college football, basketball & more.

REQUIREMENT

You'll need a license key to use OpticOdds' API. You can get one by contacting us at www.opticodds.com.

API Endpoint

https://api.opticodds.com/api/v2/leagues

Parameters

NOTE

You can pass in multiple of the same parameters in each GET request.

key (required)

Your OpticOdds API license key.

sport

NOTE

You can pass in multiple of this parameter.

The sport you want to receive leagues for. We support the following:

  • football
  • basketball
  • baseball
  • mma
  • boxing
  • hockey
  • soccer
  • tennis
  • golf
  • motorsports
  • esports
  • wrestling
  • aussie-rules
  • rugby
  • lacrosse
  • cricket
  • volleyball
  • politics

is_live

Flag to filter for odds for live leagues (supports values true, yes, t, 1)

all

Get all leagues that we offer, not just the ones that currently have games.

detailed

Get the id and the name of all the leagues that we offer.

Example Response

{
"data": [
"UEFA - Europa League",
"NHL",
"Fed-Ex 500 Round 3",
"ATP",
"Spain - La Liga",
"Boxing",
"WTA",
"Fed-Ex 500 Events",
"England - Premier League",
"France - Ligue 1",
"NCAA",
"NFL",
"Italy - Serie A",
"NBA",
"Germany - Bundesliga",
"UEFA - Champions League",
"UFC"
]
}

Example Response (detailed)

https://api.opticodds.com/api/v2/leagues?all=true&detailed=true

{
{"id": "nfl", "label": "NFL"},
{"id": "uefa_-_champions_league", "label": "UEFA - Champions League"},
...
}