Sign in

v1

latestOpenAPI 3.1.02026-07-2657157254.1 KB
polymarket

Get Events

List events with filtering and sorting.

Events are top-level groupings that contain one or more markets. Use status=open for active events only. With include_markets=true, each event carries up to markets_per_event of its markets inline (volume-sorted) — for deep per-event market pagination use GET /markets?event_slug=.

get/v2/polymarket/events/keyset

Query parameters

status'open' | 'closed'

Filter by status: open or closed

categorystring nullable

Filter by category (e.g. Sports, Crypto)

Filter by category (e.g. Sports, Crypto)

searchstring nullable

Search in title (minimum 3 characters)

Search in title (minimum 3 characters)

idstring[] nullable

Filter by event ID(s)

Filter by event ID(s)

slugstring[] nullable

Filter by event slug(s)

Filter by event slug(s)

tagstring[] nullable

Filter by tag slug(s)

Filter by tag slug(s)

sort'created' | 'created_asc' | 'start_date' | 'start_date_asc' | 'end_date' | 'end_date_desc' | 'title' | 'relevance' | 'volume_1d' | 'volume_7d' | 'volume_30d' | 'volume_all_time' | 'open_interest' | 'trades_1d' | 'trades_7d' | 'trades_30d'

Sort by

limitinteger

Number of events to return

Number of events to return

pagination_keystring nullable

Cursor returned from the previous response

Cursor returned from the previous response

offsetinteger

Deprecated. Offset pagination has been removed; only 0 is accepted.

Deprecated. Offset pagination has been removed; only 0 is accepted.

include_marketsboolean

Nest each event's markets inline (same shape as /markets)

Nest each event's markets inline (same shape as /markets)

markets_per_eventinteger

Max markets nested per event when include_markets=true

Max markets nested per event when include_markets=true

min_volumenumber nullable

Only events with 7d volume >= this (USD)

Only events with 7d volume >= this (USD)

min_open_interestnumber nullable

Only events with current open interest >= this (USD)

Only events with current open interest >= this (USD)

Response

Successful Response