List Teams

Teams for a league with logos, records, and colors.

GET /v2/sports/leagues/{code}/teams

List Teams

cURL

curl --request GET \
  --url https://api.polynode.dev/v2/sports/leagues/{code}/teams \
  --header 'x-api-key: <api-key>'

{
  "league": "nba",
  "count": 37,
  "teams": [
    {
      "id": 100519,
      "name": "Thunder",
      "league": "nba",
      "record": "60-16",
      "logo": "https://polymarket-upload.s3.us-east-2.amazonaws.com/NBA+Team+Logos/OKC.png",
      "abbreviation": "okc",
      "alias": "Thunder",
      "color": "#008ECC",
      "providerId": 27
    },
    {
      "id": 100498,
      "name": "Celtics",
      "league": "nba",
      "record": "50-25",
      "logo": "https://polymarket-upload.s3.us-east-2.amazonaws.com/NBA+Team+Logos/BOS.png",
      "abbreviation": "bos",
      "alias": "Celtics",
      "color": "#008040"
    }
  ]
}

Returns all teams for a league. Includes current season records, team logos, colors, and abbreviations.

code · string · required

League code from /v2/sports/leagues (e.g. nba, nhl, lol).

key · string · required

Your API key.

limit · integer · default: "500"

Max results (up to 500).

offset · integer · default: "0"

Pagination offset. Use for leagues with 500+ entries (ATP, UFC, Dota 2).

{
  "league": "nba",
  "count": 37,
  "teams": [
    {
      "id": 100519,
      "name": "Thunder",
      "league": "nba",
      "record": "60-16",
      "logo": "https://polymarket-upload.s3.us-east-2.amazonaws.com/NBA+Team+Logos/OKC.png",
      "abbreviation": "okc",
      "alias": "Thunder",
      "color": "#008ECC",
      "providerId": 27
    },
    {
      "id": 100498,
      "name": "Celtics",
      "league": "nba",
      "record": "50-25",
      "logo": "https://polymarket-upload.s3.us-east-2.amazonaws.com/NBA+Team+Logos/BOS.png",
      "abbreviation": "bos",
      "alias": "Celtics",
      "color": "#008040"
    }
  ]
}

Team counts by league

League	Code	Teams
NBA	nba	37
NHL	nhl	36
MLB	mlb	32
NFL	nfl	32
MLS	mls	30
EPL	epl	23
IPL	ipl	20
ATP	atp	500+
UFC	ufc	500+
LoL	lol	500+
Dota 2	dota2	500+

For leagues with 500+ entries (ATP, UFC, esports), use offset to paginate. Some esports leagues like CS2 (cs2) and Valorant (val) don’t have team roster data.

Authorizations

x-api-key · string · header · required

Path Parameters

code · string · default: nba · required

League code (e.g. nba, nhl, lol)

Query Parameters

limit · integer · default: 500

Max results (up to 500)

offset · integer · default: 0

Pagination offset

Response

200

Team list