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.
The ISV gateway exposes sports reference data - teams, logos, colors, records, and provider mappings - that complement the exchange-level Reference Data.
Teams Endpoint
GET https://gateway.polymarket.us/v1/sports/teams
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
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.
For more details on subjects and how they work across all market types, see the Subject Data page.
