Skip to main content
GET
/
v1
/
events
Get events
curl --request GET \
  --url https://gateway.polymarket.us/v1/events
{
  "events": [
    {
      "id": "<string>",
      "ticker": "<string>",
      "slug": "<string>",
      "title": "<string>",
      "subtitle": "<string>",
      "description": "<string>",
      "resolutionSource": "<string>",
      "startDate": "<string>",
      "endDate": "<string>",
      "image": "<string>",
      "icon": "<string>",
      "active": true,
      "closed": true,
      "archived": true,
      "featured": true,
      "liquidity": 123,
      "volume": 123,
      "openInterest": 123,
      "category": "<string>",
      "subcategory": "<string>",
      "createdAt": "<string>",
      "updatedAt": "<string>",
      "volume24hr": 123,
      "volume1wk": 123,
      "volume1mo": 123,
      "eventDate": "<string>",
      "startTime": "<string>",
      "eventWeek": 123,
      "seriesSlug": "<string>",
      "score": "<string>",
      "elapsed": "<string>",
      "period": "<string>",
      "live": true,
      "ended": true,
      "finishedTimestamp": "<string>",
      "gameStatus": "<string>",
      "gameId": 123,
      "sportradarGameId": "<string>",
      "latestHighlight": {
        "id": 123,
        "eventId": 123,
        "type": "<string>",
        "highlightAt": "2023-11-07T05:31:56Z",
        "title": "<string>",
        "subtitle": "<string>",
        "description": "<string>",
        "clock": "<string>",
        "score": "<string>",
        "icon": {
          "largeIcon": "<string>",
          "smallIcon": "<string>"
        },
        "teamIcon": {
          "largeIcon": "<string>",
          "smallIcon": "<string>"
        }
      },
      "eventState": {
        "id": 123,
        "gameId": 123,
        "sportradarGameId": "<string>",
        "type": "<string>",
        "score": "<string>",
        "elapsed": "<string>",
        "period": "<string>",
        "live": true,
        "ended": true,
        "finishedTimestamp": "2023-11-07T05:31:56Z",
        "footballState": {
          "down": 123,
          "yard": 123,
          "possessionProviderId": "<string>"
        }
      },
      "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>",
              "providerIds": [
                {
                  "provider": "PROVIDER_SPORTSDATAIO",
                  "providerId": "<string>"
                }
              ]
            }
          },
          "team": {
            "id": 123,
            "name": "<string>",
            "abbreviation": "<string>",
            "league": "<string>",
            "record": "<string>",
            "logo": "<string>",
            "alias": "<string>",
            "safeName": "<string>",
            "homeIcon": "<string>",
            "awayIcon": "<string>",
            "colorPrimary": "<string>",
            "providerIds": [
              {
                "provider": "PROVIDER_SPORTSDATAIO",
                "providerId": "<string>"
              }
            ]
          }
        }
      ],
      "hidden": true
    }
  ]
}

Query Parameters

​
limit
integer<int32>

Maximum number of events to return per page. Use with offset for pagination. Example: 50

​
offset
integer<int32>

Number of events to skip for pagination. Use with limit to page through results. Example: 100 skips the first 100 events

​
orderBy
string[]

Fields to sort results by. Supports multiple fields. Common values: volume, liquidity, startTime, createdAt

​
orderDirection
enum<string>

Sort direction for the orderBy fields. Use asc for ascending or desc for descending order. Default: desc

Available options:
asc,
desc
​
id
integer<int32>[]

Filter by specific event IDs. Returns only events matching these numeric identifiers

​
slug
string[]

Filter by event URL slugs. Returns only events matching these slug identifiers

​
archived
boolean

Filter by archived status. true returns only archived events, false excludes archived events from results

​
active
boolean

Filter by active status. true returns only events with active markets, false returns inactive events

​
closed
boolean

Filter by closed status. true returns only closed events, false returns open events

​
liquidityMin
number<double>

Minimum total liquidity across all markets in USD. Only returns events with liquidity >= this value

​
liquidityMax
number<double>

Maximum total liquidity across all markets in USD. Only returns events with liquidity <= this value

​
volumeMin
number<double>

Minimum total trading volume across all markets in USD. Only returns events with volume >= this value

​
volumeMax
number<double>

Maximum total trading volume across all markets in USD. Only returns events with volume <= this value

​
startDateMin
string<date-time>

Filter events starting on or after this date. ISO 8601 format. Example: 2025-01-01T00:00:00Z

​
startDateMax
string<date-time>

Filter events starting on or before this date. ISO 8601 format. Example: 2025-12-31T23:59:59Z

​
endDateMin
string<date-time>

Filter events ending on or after this date. ISO 8601 format

​
endDateMax
string<date-time>

Filter events ending on or before this date. ISO 8601 format

​
tagId
integer<int32>

Filter events by a specific tag ID. Returns only events that have this tag applied

​
relatedTags
boolean

When true and tagId is provided, also includes events with tags related to the specified tag

​
tagSlug
string

Filter events by tag slug. Returns only events that have this tag applied. Example: nfl, nba

​
featured
boolean

Filter by featured status. true returns only featured/highlighted events, false excludes featured events

​
seriesId
integer<int32>[]

Filter by series IDs. Returns events belonging to the specified series (e.g., NFL Season, NBA Playoffs)

​
eventDate
string<date>

Filter by specific event date. Format: YYYY-MM-DD. Returns events scheduled for this date

​
eventWeek
integer<int32>

Filter by event week number. For sports seasons, returns events in the specified week (e.g., NFL Week 1)

​
startTimeMin
string<date-time>

Filter events with start time on or after this timestamp. ISO 8601 format. Example: 2025-01-20T18:00:00Z

​
startTimeMax
string<date-time>

Filter events with start time on or before this timestamp. ISO 8601 format. Example: 2025-01-20T23:59:59Z

​
excludeTagId
integer<int32>[]

Exclude events with these tag IDs. Returns events that do NOT have any of these tags

​
featuredOrder
boolean

When true, sorts results by the featured order ranking instead of the default sort

​
gameId
integer<int32>

Filter by sports game ID from the data provider. Returns the event for a specific sporting game

​
period
string

Filter by game period/state. For live sports events. Example: 1H, 2H, OT, FINAL

​
ended
boolean

Filter by ended status. true returns only events that have concluded, false returns ongoing/upcoming events

​
sportradarGameId
string

Filter by Sportradar game ID. Returns the event matching this Sportradar identifier

​
excludeSeriesId
integer<int32>[]

Exclude events from these series IDs. Returns events that do NOT belong to any of these series

​
categories
string[]

Filter by event categories. Example values: sports, politics, entertainment

​
marketTypes
string[]

Filter by market types within events. Example values: binary, scalar

Response

List of events

​
events
object[]

List of events