Skip to main content
This is the top of the discovery tree. If you don’t know a specific league code yet, start here — pick a sport, then drill down into its leagues with List Leagues. 
curl -s "https://books.polynode.dev/v1/sports?key=pn_live_YOUR_KEY"
​
key
string
required
Your API key.

​
Response

{
  "count": 12,
  "sports": [
    {
      "sport_category": "baseball",
      "league_count": 3,
      "leagues": ["kbo", "mlb", "wbc"],
      "total_games_cached": 4,
      "live_games": 2
    },
    {
      "sport_category": "basketball",
      "league_count": 14,
      "leagues": [
        "bkcba", "bkcl", "bkfr1", "bkjpn", "bkkbl",
        "bkligend", "bknbl", "bkseriea", "cbb", "cwbb",
        "euroleague", "nba", "ncaab", "wnba"
      ],
      "total_games_cached": 17,
      "live_games": 0
    },
    {
      "sport_category": "cricket",
      "league_count": 16,
      "leagues": [
        "cricbbl", "criccpl", "cricipl", "criclcl", "cricmlc",
        "cricnt20c", "cricpakt20cup", "cricps", "crict20blast",
        "crict20lpl", "crict20plw", "crictbcl", "crind", "crwpl20",
        "ipl", "test"
      ],
      "total_games_cached": 4,
      "live_games": 0
    }
  ]
}

​
Fields

FieldTypeDescription
countintegerNumber of sport categories.
sports[].sport_categorystringCategory key you’ll pass as ?sport=... to other discovery endpoints.
sports[].league_countintegerHow many leagues in this category.
sports[].leaguesarrayLeague codes belonging to this category (use these with List League Games).
sports[].total_games_cachedintegerNumber of games currently in the state store for this sport (live + upcoming + recently-final).
sports[].live_gamesintegerSubset of total_games_cached that are currently in-play.

​
The 12 sport categories

CategoryWhat’s in it
soccerAll association football: EPL, La Liga, Bundesliga, MLS, South American, Asian, African leagues, UCL, UEL, World Cup
basketballNBA, WNBA, NCAA M/W, EuroLeague, LNB Pro A, Liga Endesa, KBL, Serie A (basketball), etc.
footballNFL, NCAA Football (FBS)
hockeyNHL, KHL, SHL, AHL, DEL, etc.
baseballMLB, KBO, WBC
tennisATP, WTA (individual tournaments)
mmaUFC, boxing events
cricketIPL, BBL, T20 Blast, The Hundred, international tests
esportsLeague of Legends, CS2, Valorant, Dota 2, Call of Duty, etc.
rugbyRugby Union, Rugby League
table-tennisProfessional table tennis circuits
golfMajor tournaments (limited coverage)

​
Next step

Pick a sport_category value and call List Leagues with ?sport=... to see every league in it with display names and current game counts.