Skip to Content
API ReferenceSports

Sports

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

Endpoints

GET /api/v1/sports
GET /api/v1/sports/{sportId}

These are public endpoints — no authentication required. Unauthenticated requests are rate-limited to 10 requests/minute. Authenticated requests receive your tier’s full rate limit.

List All Sports

Example Requests

# No API key required
curl -X GET "https://api.sharpapi.io/api/v1/sports"
 
# With API key for higher rate limits
curl -X GET "https://api.sharpapi.io/api/v1/sports" \
  -H "X-API-Key: YOUR_API_KEY"

Response

{
  "data": [
    {
      "id": "basketball",
      "name": "Basketball",
      "leagues": ["nba", "ncaab", "wnba"],
      "event_count": 42,
      "live_count": 3
    },
    {
      "id": "football",
      "name": "Football",
      "leagues": ["nfl", "ncaaf"],
      "event_count": 28,
      "live_count": 1
    },
    {
      "id": "hockey",
      "name": "Hockey",
      "leagues": ["nhl"],
      "event_count": 15,
      "live_count": 2
    },
    {
      "id": "baseball",
      "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": 8,
    "total": 8,
    "pagination": {
      "limit": 50,
      "offset": 0,
      "has_more": false,
      "next_offset": null
    },
    "updated_at": "2026-01-26T12:00:00Z",
    "filters": {}
  }
}

Get Single Sport

GET /api/v1/sports/{sportId}

Retrieve details for a specific sport by its ID.

Example Request

curl -X GET "https://api.sharpapi.io/api/v1/sports/basketball"

Response

{
  "data": {
    "id": "basketball",
    "name": "basketball",
    "display_name": "Basketball",
    "leagues": ["nba", "ncaab", "wnba"],
    "event_count": 42,
    "live_count": 3
  },
  "meta": {
    "updated_at": "2026-01-26T12:00:00Z"
  }
}

Error Response

404 Not Found

{
  "error": {
    "code": "not_found",
    "message": "Sport 'cricket' not found",
    "docs": "https://sharpapi.io/docs/api-reference/sports"
  }
}

Sport Object Schema

FieldTypeDescription
idstringSport identifier (lowercase, use in API filters)
namestringHuman-readable sport name
leaguesstring[]League IDs within this sport
event_countintegerTotal events currently available with odds
live_countintegerEvents currently live/in-play

Available Sports

IDDisplay NamePopular Leagues
basketballBasketballNBA, NCAAB, WNBA
footballFootballNFL, NCAAF
hockeyHockeyNHL
baseballBaseballMLB
soccerSoccerEPL, La Liga, Serie A, Bundesliga, MLS
tennisTennisATP, WTA
mmaMMAUFC
golfGolfPGA

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 Filters

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"
Last updated on
OverviewLeagues