Get Events

Retrieve all events

GET /v1/events

Get Events

cURL

curl --request GET \
  --url https://gateway.polymarket.us/v1/events

200

{
  "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"
        }
      }
    }
  ]
}

Query Parameters

limit · integer<int32>

Maximum number of events to return

offset · integer<int32>

Number of events to skip for pagination

orderBy · string[]

Fields to order results by

orderDirection · string

Order direction (asc or desc)

id · integer<int32>[]

Filter by event IDs

slug · string[]

Filter by event slugs

archived · boolean

Filter by archived status

active · boolean

Filter by active status

closed · boolean

Filter by closed status

liquidityMin · number<double>

Minimum liquidity filter

liquidityMax · number<double>

Maximum liquidity filter

volumeMin · number<double>

Minimum volume filter

volumeMax · number<double>

Maximum volume filter

startDateMin · string

Minimum start date filter

startDateMax · string

Maximum start date filter

endDateMin · string

Minimum end date filter

endDateMax · string

Maximum end date filter

relatedTags · boolean

Include related tags

tagSlug · string

Filter by tag slug

userId · string

Filter by user ID

featured · boolean

Filter by featured status

seriesId · integer<int32>[]

Filter by series IDs

eventDate · string

Filter by event date

eventWeek · integer<int32>

Filter by event week number

startTimeMin · string

Minimum start time filter

startTimeMax · string

Maximum start time filter

excludeTagId · integer<int32>[]

Tag IDs to exclude

featuredOrder · boolean

Order by featured position

includeTemplate · boolean

Include template events

recurrence · string

Filter by recurrence type

createdBy · string[]

Filter by creator IDs

gameId · integer<int32>

Filter by game ID

rescheduledFromGameId · integer<int32>

Filter by rescheduled from game ID

period · string

Filter by event period

finishedTimestampMin · string

Minimum finished timestamp filter

finishedTimestampMax · string

Maximum finished timestamp filter

ended · boolean

Filter by ended status

sportradarGameId · string

Filter by Sportradar game ID

excludeSeriesId · integer<int32>[]

Series IDs to exclude

resolution · boolean

Filter by resolution status

categories · string[]

Filter by categories

marketTypes · string[]

Filter by market types

live · boolean

Filter by live status

excludeEventId · integer<int32>[]

Event IDs to exclude

includeHidden · boolean

Include hidden events (default: false)

tagIds · integer<int32>[]

Filter by tag IDs

Response

200

application/json

List of events

Response containing list of events

events · object[]

List of events

Show child attributes