Sports

Get a list of all available sports with their leagues and event counts.

EndpointsPermalink for this section


GET /api/v1/sports

Requires an API key. Available on all tiers (Free included). Unauthenticated requests return 401.

List All SportsPermalink for this section

Example RequestsPermalink for this section

cURL


curl -X GET "https://api.sharpapi.io/api/v1/sports" \
  -H "X-API-Key: YOUR_API_KEY"

JavaScript


const response = await fetch('https://api.sharpapi.io/api/v1/sports', {
  headers: { 'X-API-Key': 'YOUR_API_KEY' },
});
const { data, meta } = await response.json();
 
data.forEach(sport => {
  console.log(`${sport.name}: ${sport.event_count} events (${sport.live_count} live)`);
  console.log(`  Leagues: ${sport.leagues.join(', ')}`);
});

Python


import requests
 
response = requests.get(
    'https://api.sharpapi.io/api/v1/sports',
    headers={'X-API-Key': 'YOUR_API_KEY'},
)
result = response.json()
 
for sport in result['data']:
    print(f"{sport['name']}: {sport['event_count']} events ({sport['live_count']} live)")
    print(f"  Leagues: {', '.join(sport['leagues'])}")

ResponsePermalink for this section


{
  "data": [
    {
      "id": "basketball",
      "numerical_id": 1,
      "name": "Basketball",
      "leagues": ["nba", "ncaab", "wnba"],
      "event_count": 42,
      "live_count": 3
    },
    {
      "id": "football",
      "numerical_id": 2,
      "name": "Football",
      "leagues": ["nfl", "ncaaf"],
      "event_count": 28,
      "live_count": 1
    },
    {
      "id": "hockey",
      "numerical_id": 4,
      "name": "Hockey",
      "leagues": ["nhl"],
      "event_count": 15,
      "live_count": 2
    },
    {
      "id": "baseball",
      "numerical_id": 3,
      "name": "Baseball",
      "leagues": ["mlb"],
      "event_count": 0,
      "live_count": 0
    },
    {
      "id": "soccer",
      "name": "Soccer",
      "leagues": ["epl", "la_liga", "serie_a", "bundesliga", "mls"],
      "event_count": 35,
      "live_count": 4
    },
    {
      "id": "tennis",
      "name": "Tennis",
      "leagues": ["atp", "wta"],
      "event_count": 18,
      "live_count": 6
    },
    {
      "id": "mma",
      "name": "MMA",
      "leagues": ["ufc"],
      "event_count": 12,
      "live_count": 0
    },
    {
      "id": "golf",
      "name": "Golf",
      "leagues": ["pga"],
      "event_count": 4,
      "live_count": 1
    }
  ],
  "meta": {
    "count": 19,
    "total": 19,
    "pagination": {
      "limit": 50,
      "offset": 0,
      "has_more": false,
      "next_offset": null
    },
    "updated_at": "2026-01-26T12:00:00Z",
    "filters": {}
  }
}

Sport Object SchemaPermalink for this section

Field	Type	Description
`id`	string	Sport identifier (lowercase, use in API filters)
`numerical_id`	integer \| null	Stable integer key for the sport (frozen, never reused). New (May 2026) — additive, optional. See Entity reference IDs.
`name`	string	Human-readable sport name
`leagues`	string[]	League IDs within this sport
`event_count`	integer	Total events currently available with odds
`live_count`	integer	Events currently live/in-play

New (May 2026): `numerical_id`Permalink for this section

numerical_id is a frozen, dense-from-1 integer assigned per sport in the SharpAPI atlas. Use it as a compact storage key when you don’t need the human-readable slug.

Frozen: never reused or remapped once assigned.
Optional: absent (or null) for sports that haven’t been mapped yet — the slug id is always present.
Domain-scoped: unique across sports only; pair with the entity domain to disambiguate.

See Entity reference IDs for the full semantics, plus the matching sport_ref block emitted on every odds row and opportunity leg.

Available SportsPermalink for this section

ID	Display Name	Popular Leagues
`basketball`	Basketball	NBA, NCAAB, WNBA
`football`	Football	NFL, NCAAF
`hockey`	Hockey	NHL
`baseball`	Baseball	MLB
`soccer`	Soccer	EPL, La Liga, Serie A, Bundesliga, MLS
`tennis`	Tennis	ATP, WTA
`mma`	MMA	UFC
`golf`	Golf	PGA
`boxing`	Boxing	—
`cricket`	Cricket	—
`rugby`	Rugby Union	—
`rugby_league`	Rugby League	—
`lacrosse`	Lacrosse	PLL
`motorsports`	Motorsports	F1, NASCAR
`curling`	Curling	—
`darts`	Darts	PDC
`snooker`	Snooker	—
`table_tennis`	Table Tennis	—
`esports`	Esports	LoL, CS2, Dota 2

The event_count and live_count values are dynamic and change based on current schedules. Off-season sports will show 0 events.

Using Sports in FiltersPermalink for this section

Use the sport id as a filter parameter on other endpoints:


# Get odds for basketball only
curl "https://api.sharpapi.io/api/v1/odds?sport=basketball" \
  -H "X-API-Key: YOUR_API_KEY"
 
# Get events for multiple sports
curl "https://api.sharpapi.io/api/v1/events?sport=basketball,football" \
  -H "X-API-Key: YOUR_API_KEY"

Leagues - List leagues with optional sport filter
Odds Snapshot - Filter odds by sport
Events - Filter events by sport