Teams Endpoint
filters.league parameter to specify the series, which corresponds to the event_series value in instrument metadata (e.g., nfl, nba, nhl, mlb, mls, cbb, cfb).
Query Parameters
| Parameter | Type | Description |
|---|---|---|
limit | int32 | Maximum number of teams to return |
offset | int32 | Number of teams to skip for pagination |
filters.league | string | Series to filter by (see examples below) |
filters.name | string | Filter by team name |
filters.abbreviation | string | Filter by team abbreviation |
filters.id | int64 | Filter by team ID |
Examples by Series
Substitute the series value infilters.league to get teams for different leagues:
| Series | URL |
|---|---|
| NFL | https://gateway.polymarket.us/v1/sports/teams?limit=500&filters.league=nfl |
| NBA | https://gateway.polymarket.us/v1/sports/teams?limit=500&filters.league=nba |
| NHL | https://gateway.polymarket.us/v1/sports/teams?limit=500&filters.league=nhl |
| MLB | https://gateway.polymarket.us/v1/sports/teams?limit=500&filters.league=mlb |
| MLS | https://gateway.polymarket.us/v1/sports/teams?limit=500&filters.league=mls |
| CBB | https://gateway.polymarket.us/v1/sports/teams?limit=500&filters.league=cbb |
| CFB | https://gateway.polymarket.us/v1/sports/teams?limit=500&filters.league=cfb |
| UFC | https://gateway.polymarket.us/v1/sports/teams?limit=500&filters.league=ufc |
| UCL | https://gateway.polymarket.us/v1/sports/teams?limit=500&filters.league=ucl |
Response Fields
Each team object includes:| Field | Type | Description |
|---|---|---|
id | string | Internal team ID |
name | string | Full team name (e.g., “Buffalo Bills”) |
abbreviation | string | Team abbreviation (e.g., buf) |
league | string | Series identifier (e.g., nfl) |
record | string | Current win-loss record |
logo | string | URL to team logo image |
alias | string | Team nickname |
colorPrimary | string | Team primary color (hex) |
conference | string | Conference or division |
providerRefs | array | External data provider ID mappings |