---
title: "Get Events"
method: GET
path: "/v2/polymarket/events/keyset"
tags: ["polymarket"]
---

# Get Events

`GET /v2/polymarket/events/keyset`

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=.

## Query parameters

- `status` 'open' | 'closed'
- `category` string, nullable — Filter by category (e.g. Sports, Crypto)
- `search` string, nullable — Search in title (minimum 3 characters)
- `id` string[], nullable — Filter by event ID(s)
- `slug` string[], nullable — Filter by event slug(s)
- `tag` string[], nullable — 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'
- `limit` integer — Number of events to return
- `pagination_key` string, nullable — Cursor returned from the previous response
- `offset` integer — Deprecated. Offset pagination has been removed; only 0 is accepted.
- `include_markets` boolean — Nest each event's markets inline (same shape as /markets)
- `markets_per_event` integer — Max markets nested per event when include_markets=true
- `min_volume` number, nullable — Only events with 7d volume >= this (USD)
- `min_open_interest` number, nullable — Only events with current open interest >= this (USD)

## Response `200`

Successful Response

- PolymarketEventsResponse — Response for Polymarket events list endpoint.
  - `events` PolymarketEvent[], required
    - `id` string, required
    - `ticker` string
    - `slug` string
    - `title` string
    - `description` string
    - `category` string
    - `tags` object[]
    - `series` object[]
    - `image_url` string
    - `icon_url` string
    - `resolution_source` string
    - `start_date` string, nullable — ISO 8601 timestamp
    - `end_date` string, nullable — ISO 8601 timestamp
    - `creation_date` string, nullable — ISO 8601 timestamp
    - `closed_time` string, nullable — ISO 8601 timestamp
    - `neg_risk` boolean
    - `neg_risk_market_id` string, nullable
    - `enable_order_book` boolean
    - `status` string
    - `market_count` integer
    - `total_volume_usd` number
    - `trades_all_time` integer
    - `liquidity_usd` number
    - `current_oi_usd` number
    - `rolling_metrics` object, nullable
    - `markets` PolymarketMarket[], nullable
      - `condition_id` string, required
      - `question_id` string, nullable
      - `market_id` string, required
      - `market_slug` string, required
      - `title` string, required
      - `description` string
      - `status` string, required
      - `winning_side` string, nullable
      - `start_time` string, nullable — ISO 8601 timestamp
      - `end_time` string, nullable — ISO 8601 timestamp
      - `close_time` string, nullable — ISO 8601 timestamp
      - `created_time` string, nullable — ISO 8601 timestamp
      - `image_url` string
      - `event_id` string, nullable
      - `event_slug` string, nullable
      - `event_title` string, nullable
      - `outcomes` PolymarketOutcome[], required
        - `label` string, required
        - `token_id` string, nullable
        - `predexon_id` string, nullable
        - `price` number, nullable
      - `total_volume_usd` number
      - `liquidity_usd` number
      - `tags` string[]
      - `is_neg_risk` boolean
      - `rolling_metrics` MarketRollingMetrics — Rolling window metrics from market_metrics_summary (hourly cron refresh).
        - `volume_1d` number — Volume in USD over last 24 hours
        - `volume_7d` number — Volume in USD over last 7 days
        - `volume_30d` number — Volume in USD over last 30 days
        - `buy_volume_1d` number — Buy volume (USD) last 24h
        - `buy_volume_7d` number — Buy volume (USD) last 7d
        - `buy_volume_30d` number — Buy volume (USD) last 30d
        - `sell_volume_1d` number — Sell volume (USD) last 24h
        - `sell_volume_7d` number — Sell volume (USD) last 7d
        - `sell_volume_30d` number — Sell volume (USD) last 30d
        - `trades_1d` integer — Trade count last 24h
        - `trades_7d` integer — Trade count last 7d
        - `trades_30d` integer — Trade count last 30d
        - `buys_1d` integer — Buy trades last 24h
        - `buys_7d` integer — Buy trades last 7d
        - `buys_30d` integer — Buy trades last 30d
        - `sells_1d` integer — Sell trades last 24h
        - `sells_7d` integer — Sell trades last 7d
        - `sells_30d` integer — Sell trades last 30d
        - `oi_change_1d` number — OI change over last 24h (USD)
        - `oi_change_7d` number — OI change over last 7d (USD)
        - `oi_change_30d` number — OI change over last 30d (USD)
        - `computed_at` string, nullable — ISO 8601 timestamp when metrics were last computed
  - `pagination` CursorPagination, required — Cursor-based pagination for endpoints that don't support offset.
    - `limit` integer, required — Requested limit
    - `count` integer, required — Number of items in current response
    - `pagination_key` string, nullable — Base64-encoded cursor for next page
    - `has_more` boolean, required — Whether there are more items available

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/predexon/apis/predexon-api.md) · [All operations](https://skmtc.net/predexon/apis/predexon-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/predexon/predexon-api/versions/80a306fbdb39/schema)