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 API
The Sports API provides access to sporting events organized by league or sport.
Endpoints
| Method | Endpoint | Description |
|---|
GET | /v2/leagues/{slug}/events | Get events by league slug |
GET | /v2/sports/{slug}/events | Get events by sport slug |
Get League Events
Retrieve events for a specific league:
GET /v2/leagues/nfl/events
Path Parameters
| Parameter | Type | Description |
|---|
slug | string | League slug (e.g., nfl, nba, mlb) |
Query Parameters
| Parameter | Type | Description |
|---|
limit | integer | Pagination limit |
offset | integer | Pagination offset |
excludeEventId | array | Event IDs to exclude |
type | string | Type: sport (default) or futures |
section | string | Section: general (default) or trending |
Get Sport Events
Retrieve events for all leagues under a sport:
GET /v2/sports/football/events
Path Parameters
| Parameter | Type | Description |
|---|
slug | string | Sport slug (e.g., football, basketball) |
Query Parameters
| Parameter | Type | Description |
|---|
limit | integer | Pagination limit |
offset | integer | Pagination offset |
excludeEventId | array | Event IDs to exclude |
type | string | Type: sport (default) or futures |
section | string | Section: general (default) or trending |
Teams
For fetching team information, use the Sports (Legacy) API.
