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.

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.

For more details on subjects and how they work across all market types, see the Subject Data page.