> ## Documentation Index
> Fetch the complete documentation index at: https://docs.polymarket.us/llms.txt
> Use this file to discover all available pages before exploring further.

# Sports Data

> Sports teams and league data available through the ISV gateway

The ISV gateway exposes sports reference data - teams, logos, colors, records, and provider mappings - that complement the exchange-level [Reference Data](/data-guide/reference-data).

## Teams Endpoint

```
GET https://gateway.polymarket.us/v1/sports/teams
```

Returns team data for a given series. Use the `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 in `filters.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` |
| EPL    | `https://gateway.polymarket.us/v1/sports/teams?limit=500&filters.league=epl` |
| ATP    | `https://gateway.polymarket.us/v1/sports/teams?limit=500&filters.league=atp` |
| WTA    | `https://gateway.polymarket.us/v1/sports/teams?limit=500&filters.league=wta` |

### 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     |

## Events Endpoint

```
GET https://gateway.polymarket.us/v2/leagues/{slug}/events
```

Returns active events for a given league.

### Query Parameters

| Parameter | Type    | Description                        |
| --------- | ------- | ---------------------------------- |
| `limit`   | integer | Maximum number of events to return |
| `active`  | boolean | Filter to active events            |
| `closed`  | boolean | Filter by closed status            |

### Examples by League

| League | URL                                                                                       |
| ------ | ----------------------------------------------------------------------------------------- |
| NFL    | `https://gateway.polymarket.us/v2/leagues/nfl/events?limit=1000&active=true&closed=false` |
| NBA    | `https://gateway.polymarket.us/v2/leagues/nba/events?limit=1000&active=true&closed=false` |
| NHL    | `https://gateway.polymarket.us/v2/leagues/nhl/events?limit=1000&active=true&closed=false` |
| MLB    | `https://gateway.polymarket.us/v2/leagues/mlb/events?limit=1000&active=true&closed=false` |
| MLS    | `https://gateway.polymarket.us/v2/leagues/mls/events?limit=1000&active=true&closed=false` |
| CBB    | `https://gateway.polymarket.us/v2/leagues/cbb/events?limit=1000&active=true&closed=false` |
| CFB    | `https://gateway.polymarket.us/v2/leagues/cfb/events?limit=1000&active=true&closed=false` |
| UFC    | `https://gateway.polymarket.us/v2/leagues/ufc/events?limit=1000&active=true&closed=false` |
| UCL    | `https://gateway.polymarket.us/v2/leagues/ucl/events?limit=1000&active=true&closed=false` |
| EPL    | `https://gateway.polymarket.us/v2/leagues/epl/events?limit=1000&active=true&closed=false` |
| ATP    | `https://gateway.polymarket.us/v2/leagues/atp/events?limit=1000&active=true&closed=false` |
| WTA    | `https://gateway.polymarket.us/v2/leagues/wta/events?limit=1000&active=true&closed=false` |

## When Sports Markets Use Subjects Instead of Teams

Teams are used for standard game markets (moneylines, spreads, totals) where two teams are competing in a specific game. In these cases, team data is attached directly to the event as participants.

However, non-championship futures markets for sports — such as MVP awards, season win totals, and other prop futures that aren't tied to a specific game outcome — use **subjects** instead of teams. Subjects represent the individual player, team, or entity that the futures market is about.