List Teams - Polymarket Data SDK

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

Name	Type	Default	Notes
`limit`	`number` (≥ 0)	–	Number of results.
`offset`	`number` (≥ 0)	–	Pagination offset.
`order`	`string`	–	Comma-separated fields to sort by.
`ascending`	`boolean`	–	Sort direction.
`league`	`string[]`	–	Filter by league identifiers (e.g., `"NBA"`).
`name`	`string[]`	–	Filter by team names.
`abbreviation`	`string[]`	–	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.

​Request

​Parameters

​Response

​Usage example

​Failure modes

Request

Parameters

Response

Usage example

Failure modes