Skip to main content
GET
/
v2
/
leagues
/
{slug}
/
events
Get Events By League Slug
curl --request GET \
  --url https://gateway.polymarket.us/v2/leagues/{slug}/events
{
  "type": "<string>",
  "typeTitle": "<string>",
  "section": "<string>",
  "sectionTitle": "<string>",
  "events": [
    {
      "id": "<string>",
      "ticker": "<string>",
      "slug": "<string>",
      "title": "<string>",
      "subtitle": "<string>",
      "description": "<string>",
      "resolutionSource": "<string>",
      "startDate": "<string>",
      "creationDate": "<string>",
      "endDate": "<string>",
      "image": "<string>",
      "active": true,
      "closed": true,
      "archived": true,
      "liquidity": 123,
      "volume": 123,
      "openInterest": 123,
      "category": "<string>",
      "subcategory": "<string>",
      "createdAt": "<string>",
      "updatedAt": "<string>",
      "volume24hr": 123,
      "volume1wk": 123,
      "volume1mo": 123,
      "volume1yr": 123,
      "closedTime": "<string>",
      "eventDate": "<string>",
      "startTime": "<string>",
      "eventWeek": 123,
      "seriesSlug": "<string>",
      "score": "<string>",
      "elapsed": "<string>",
      "period": "<string>",
      "live": true,
      "ended": true,
      "finishedTimestamp": "<string>",
      "featuredOrder": 123,
      "gameStatus": "<string>",
      "markets": [
        {
          "id": "<string>",
          "question": "<string>",
          "slug": "<string>",
          "endDate": "<string>",
          "category": "<string>",
          "startDate": "<string>",
          "image": "<string>",
          "description": "<string>",
          "active": true,
          "marketType": "<string>",
          "closed": true,
          "createdAt": "<string>",
          "updatedAt": "<string>",
          "archived": true,
          "orderPriceMinTickSize": 123,
          "gameStartTime": "<string>",
          "bestBid": 123,
          "bestAsk": 123,
          "manualActivation": true,
          "sportsMarketType": "<string>",
          "line": 123,
          "marketSides": [
            {
              "id": "<string>",
              "marketSideType": "MARKET_SIDE_TYPE_ERC1155",
              "identifier": "<string>",
              "createdAt": "<string>",
              "updatedAt": "<string>",
              "description": "<string>",
              "price": "<string>",
              "marketId": 123,
              "long": true,
              "teamId": 123,
              "team": {
                "id": 123,
                "name": "<string>",
                "abbreviation": "<string>",
                "league": "<string>",
                "record": "<string>",
                "logo": "<string>",
                "alias": "<string>",
                "safeName": "<string>",
                "homeIcon": "<string>",
                "awayIcon": "<string>",
                "colorPrimary": "<string>",
                "providerId": 123,
                "ordering": "<string>",
                "longIcon": "<string>",
                "shortIcon": "<string>",
                "displayAbbreviation": "<string>",
                "ranking": "<string>",
                "conference": "<string>",
                "providerIds": [
                  {
                    "provider": "PROVIDER_SPORTSDATAIO",
                    "providerId": "<string>"
                  }
                ],
                "longIconDark": "<string>",
                "shortIconDark": "<string>"
              },
              "participantId": "<string>"
            }
          ],
          "outcomes": "<string>",
          "outcomePrices": "<string>",
          "ep3Status": "<string>",
          "sportsMarketTypeV2": "SPORTS_MARKET_TYPE_MONEYLINE",
          "hidden": true,
          "tags": [
            {
              "id": "<string>",
              "label": "<string>",
              "slug": "<string>",
              "forceShow": true,
              "publishedAt": "<string>",
              "createdBy": 123,
              "updatedBy": 123,
              "createdAt": "<string>",
              "updatedAt": "<string>",
              "forceHide": true,
              "isCarousel": true,
              "image": "<string>",
              "tradable": true,
              "subtags": [
                {}
              ]
            }
          ],
          "title": "<string>",
          "subtitle": "<string>",
          "color": "<string>",
          "darkColor": "<string>",
          "subjectId": 123,
          "subject": {
            "id": 123,
            "name": "<string>",
            "displayName": "<string>",
            "description": "<string>",
            "subjectType": "<string>",
            "image": "<string>",
            "color": "<string>",
            "darkColor": "<string>",
            "createdAt": "<string>",
            "updatedAt": "<string>"
          }
        }
      ],
      "gameId": 123,
      "rescheduledFromGameId": 123,
      "sportradarGameId": "<string>",
      "eventState": {
        "id": 123,
        "gameId": 123,
        "sportradarGameId": "<string>",
        "type": "<string>",
        "createdAt": "2023-11-07T05:31:56Z",
        "updatedAt": "2023-11-07T05:31:56Z",
        "score": "<string>",
        "elapsed": "<string>",
        "period": "<string>",
        "live": true,
        "ended": true,
        "finishedTimestamp": "2023-11-07T05:31:56Z",
        "footballState": {
          "down": 123,
          "yard": 123,
          "possessionProviderId": "<string>"
        },
        "ufcState": {
          "weightClass": "<string>",
          "cardSegment": "<string>",
          "eventLogo": "<string>",
          "rounds": 123,
          "order": 123
        },
        "tennisState": {
          "tournamentName": "<string>",
          "round": "<string>"
        },
        "mainSpreadLine": 123,
        "mainTotalLine": 123
      },
      "participants": [
        {
          "id": "<string>",
          "type": "PARTICIPANT_TYPE_NOMINEE",
          "nominee": {
            "id": "<string>",
            "name": "<string>"
          },
          "player": {
            "id": "<string>",
            "name": "<string>",
            "team": {
              "id": 123,
              "name": "<string>",
              "abbreviation": "<string>",
              "league": "<string>",
              "record": "<string>",
              "logo": "<string>",
              "alias": "<string>",
              "safeName": "<string>",
              "homeIcon": "<string>",
              "awayIcon": "<string>",
              "colorPrimary": "<string>",
              "providerId": 123,
              "ordering": "<string>",
              "longIcon": "<string>",
              "shortIcon": "<string>",
              "displayAbbreviation": "<string>",
              "ranking": "<string>",
              "conference": "<string>",
              "providerIds": [
                {
                  "provider": "PROVIDER_SPORTSDATAIO",
                  "providerId": "<string>"
                }
              ],
              "longIconDark": "<string>",
              "shortIconDark": "<string>"
            }
          },
          "team": {
            "id": 123,
            "name": "<string>",
            "abbreviation": "<string>",
            "league": "<string>",
            "record": "<string>",
            "logo": "<string>",
            "alias": "<string>",
            "safeName": "<string>",
            "homeIcon": "<string>",
            "awayIcon": "<string>",
            "colorPrimary": "<string>",
            "providerId": 123,
            "ordering": "<string>",
            "longIcon": "<string>",
            "shortIcon": "<string>",
            "displayAbbreviation": "<string>",
            "ranking": "<string>",
            "conference": "<string>",
            "providerIds": [
              {
                "provider": "PROVIDER_SPORTSDATAIO",
                "providerId": "<string>"
              }
            ],
            "longIconDark": "<string>",
            "shortIconDark": "<string>"
          }
        }
      ],
      "hidden": true,
      "tags": [
        {
          "id": "<string>",
          "label": "<string>",
          "slug": "<string>",
          "forceShow": true,
          "publishedAt": "<string>",
          "createdBy": 123,
          "updatedBy": 123,
          "createdAt": "<string>",
          "updatedAt": "<string>",
          "forceHide": true,
          "isCarousel": true,
          "image": "<string>",
          "tradable": true,
          "subtags": [
            {}
          ]
        }
      ],
      "teams": [
        {
          "id": 123,
          "name": "<string>",
          "abbreviation": "<string>",
          "league": "<string>",
          "record": "<string>",
          "logo": "<string>",
          "alias": "<string>",
          "safeName": "<string>",
          "homeIcon": "<string>",
          "awayIcon": "<string>",
          "colorPrimary": "<string>",
          "providerId": 123,
          "ordering": "<string>",
          "longIcon": "<string>",
          "shortIcon": "<string>",
          "displayAbbreviation": "<string>",
          "ranking": "<string>",
          "conference": "<string>",
          "providerIds": [
            {
              "provider": "PROVIDER_SPORTSDATAIO",
              "providerId": "<string>"
            }
          ],
          "longIconDark": "<string>",
          "shortIconDark": "<string>"
        }
      ],
      "metadata": {
        "gameState": {
          "id": 123,
          "gameId": 123,
          "sportradarGameId": "<string>",
          "type": "<string>",
          "createdAt": "2023-11-07T05:31:56Z",
          "updatedAt": "2023-11-07T05:31:56Z",
          "score": "<string>",
          "elapsed": "<string>",
          "period": "<string>",
          "live": true,
          "ended": true,
          "finishedTimestamp": "2023-11-07T05:31:56Z",
          "footballState": {
            "down": 123,
            "yard": 123,
            "possessionProviderId": "<string>"
          },
          "ufcState": {
            "weightClass": "<string>",
            "cardSegment": "<string>",
            "eventLogo": "<string>",
            "rounds": 123,
            "order": 123
          },
          "tennisState": {
            "tournamentName": "<string>",
            "round": "<string>"
          },
          "mainSpreadLine": 123,
          "mainTotalLine": 123
        },
        "latestGameUpdate": {
          "id": 123,
          "eventId": 123,
          "sportradarGameId": "<string>",
          "type": "<string>",
          "title": "<string>",
          "subtitle": "<string>",
          "subject": "<string>",
          "team": "<string>",
          "period": "<string>",
          "clock": "<string>",
          "highlightAt": "2023-11-07T05:31:56Z",
          "createdAt": "2023-11-07T05:31:56Z"
        }
      }
    }
  ],
  "league": {
    "name": "<string>",
    "slug": "<string>",
    "image": "<string>",
    "isOperational": true,
    "automaticResolution": true
  }
}

Path Parameters

slug
string
required

League slug (e.g., 'nfl', 'nba')

Query Parameters

limit
integer<int32>

Pagination limit

offset
integer<int32>

Pagination offset

excludeEventId
integer<int32>[]

Event IDs to exclude

type
string

Type: sport (default) or futures

section
string

Section: general (default) or trending

Response

League events with league info

Response containing events for a league

type
string

Type: sport or futures

typeTitle
string

Subtab title: Games or Futures

section
string

Section: general or trending

sectionTitle
string

Section title: Sport or Trending

events
object[]

Events in this section

league
object

Consumer-facing league representation