Discovery

List events

List specific events within series (e.g., "Lakers vs Bulls", "Iowa Caucus").

Supports filtering by date ranges, text search, tags, and pagination. Results are sorted by the selected field (default: updated_at desc).

Pagination: Use the next_cursor value from the response to fetch the next page.

get/v1/events

Request

  • Base URL: https://api.polymarketdata.co
  • URL: https://api.polymarketdata.co/v1/events
  • Auth: API key in header X-API-Key

Query parameters

searchstring

Optional case-insensitive text match for event title or slug.

Example:debate
limitinteger

Maximum number of items returned in this page.

Example:100
cursorstring

Opaque cursor from a previous metadata.next_cursor value.

start_date_minstring

Filter for events with start_date greater than or equal to this ISO 8601 timestamp.

Example:2026-01-01T00:00:00Z
start_date_maxstring

Filter for events with start_date less than or equal to this ISO 8601 timestamp.

Example:2026-12-31T23:59:59Z
end_date_minstring

Filter for events with end_date greater than or equal to this ISO 8601 timestamp.

Example:2026-01-01T00:00:00Z
end_date_maxstring

Filter for events with end_date less than or equal to this ISO 8601 timestamp.

Example:2026-12-31T23:59:59Z
tagsstring[] nullable

Filter by event tags. Supports repeated params and comma-separated values.

tags_match'any' | 'all'

Tag match behavior for filtering.

Tag matching strategy: any (OR) or all (AND).

sort'created_at' | 'updated_at'

Sortable fields for discovery listings.

Field used to sort the response rows.

order'asc' | 'desc'

Sort direction for discovery listings.

Sort direction.

Response

Paginated list of events.

Example response

{
  "data": [
    {
      "end_date": "2025-09-15T04:00:00Z",
      "id": "201",
      "slug": "lakers-vs-bulls-2025-09-15",
      "start_date": "2025-09-15T01:00:00Z",
      "status": "open",
      "tags": [
        "basketball",
        "nba"
      ],
      "title": "Lakers vs Bulls"
    }
  ],
  "metadata": {
    "count": 1,
    "limit": 100
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.