Skip to main content
client.gamma.sports.listTeams exposes the teams tracked by Polymarket across supported leagues. Use it to populate dropdowns, leaderboards, or sports dashboards.

Request

const teams = await client.gamma.sports.listTeams(params);

Parameters

NameTypeRequiredDefaultNotes
limitnumber (≥ 0)Number of results.
offsetnumber (≥ 0)Pagination offset.
orderstringComma-separated fields to sort by.
ascendingbooleanSort direction.
leaguestring[]Filter by league identifiers (e.g., "NBA").
namestring[]Filter by team names.
abbreviationstring[]Filter by abbreviations.

Response

type Team = {
  id: number;
  name: string | null;
  league: string | null;
  record: string | null;
  logo: string | null;
  abbreviation: string | null;
  alias: string | null;
  createdAt: string | null;
  updatedAt: string | null;
  providerId: number | null;
};

Usage example

const nbaTeams = await client.gamma.sports.listTeams({ league: ["NBA"], limit: 50 });

nbaTeams.forEach((team) => console.log(team.name));

Failure modes

  • Numeric parameters must be non-negative.
  • Empty arrays (e.g., league: []) trigger validation errors.