---
title: "List Polymarket events"
method: GET
path: "/polymarket/events"
tags: ["Polymarket"]
---

# List Polymarket events

`GET /polymarket/events`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/polymarket/events`
- Auth: API key in header `x-api-key`

Lists Polymarket events with their markets. Sort by 24-hour volume, total volume, liquidity, end date and more, filter to open or closed events, and page with `limit` (default 25, max 100) and `offset`. Each event has its slug, description, end date, liquidity, open interest and comment count; each market has its question, outcomes, best bid and ask, last trade price and volume.

## Query parameters

- `limit` integer
- `offset` integer
- `order` 'volume24hr' | 'volume' | 'liquidity' | 'endDate' | 'updatedAt' | 'createdAt' | 'id' | 'slug' | 'title' | 'question' | 'label'
- `ascending` boolean
- `closed` 'true' | 'false'

## Headers

- `x-api-key` string, required

## Response `200`

OK

- PolymarketEventsResponseDoc
  - `code` integer
  - `data` PolymarketEventsResponse
    - `ascending` boolean: `true` when events are sorted in ascending order.
    - `closed` string: Closed filter applied, `true` or `false`.
    - `events` PolymarketEventSummary[]: Events on this page, one item per event.
      - `active` boolean: `true` when the event is active.
      - `closed` boolean: `true` when the event is closed.
      - `comment_count` integer: Number of comments on the event.
      - `description` string: Event description as shown on Polymarket.
      - `end_date` string: Date and time the event is scheduled to end (ISO 8601).
      - `featured` boolean: `true` when Polymarket features the event.
      - `icon_url` string: URL of the event's icon image.
      - `id` string: Polymarket event id.
      - `image_url` string: URL of the event's main image.
      - `liquidity` number: Liquidity Polymarket reports for the event.
      - `markets` PolymarketMarketSummary[]: Markets inside the event, one item per market.
        - `active` boolean: `true` when the market is active.
        - `best_ask` number: Lowest ask price currently offered on the market.
        - `best_bid` number: Highest bid price currently offered on the market.
        - `closed` boolean: `true` when the market is closed.
        - `condition_id` string: Condition id that identifies the market on Polymarket.
        - `end_date` string: Date and time the market is scheduled to end (ISO 8601).
        - `id` string: Polymarket market id.
        - `last_trade_price` number: Price of the most recent trade on the market.
        - `liquidity` number: Liquidity Polymarket reports for the market.
        - `outcomes` PolymarketOutcomePricePoint[]: Outcomes of the market with their current prices, one item per outcome.
          - `best_ask` number: Lowest ask price currently offered for the outcome.
          - `best_bid` number: Highest bid price currently offered for the outcome.
          - `last_trade_price` number: Price of the most recent trade on the outcome.
          - `liquidity` number: Liquidity Polymarket reports for the outcome.
          - `market_id` string: Polymarket id of the market the outcome belongs to.
          - `market_slug` string: URL slug of the market the outcome belongs to.
          - `outcome` string: Name of the outcome, for example `Yes`.
          - `price` number: Current price of the outcome.
          - `question` string: Question of the market the outcome belongs to.
          - `volume` number: Trading volume Polymarket reports for the outcome.
        - `question` string: Question the market asks, for example `Will Spain win the 2026 FIFA World Cup?`.
        - `slug` string: URL slug of the market.
        - `token_ids` string[]: Token ids of the market outcomes, in the same order as `outcomes`.
        - `url` string: Link to the market on polymarket.com.
        - `volume` number: Total trading volume of the market.
        - `volume_24h` number: Trading volume of the market over the last 24 hours.
      - `markets_count` integer: Number of markets inside the event.
      - `open_interest` number: Open interest Polymarket reports for the event.
      - `restricted` boolean: `true` when Polymarket marks the event as restricted.
      - `slug` string: URL slug of the event.
      - `start_date` string: Date and time the event starts (ISO 8601).
      - `tags` PolymarketTagSummary[]: Tags attached to the event, one item per tag.
        - `id` string: Polymarket tag id.
        - `label` string: Display name of the tag, for example `Crypto`.
        - `slug` string: URL slug of the tag, for example `crypto`.
      - `title` string: Event title as shown on Polymarket.
      - `updated_at` string: Time Polymarket last updated the event (ISO 8601).
      - `url` string: Link to the event on polymarket.com.
      - `volume` number: Total trading volume of the event.
      - `volume_24h` number: Trading volume of the event over the last 24 hours.
    - `fetched_at` string: Time the data was fetched, in UTC (RFC 3339).
    - `limit` integer: Maximum number of events requested.
    - `offset` integer: Number of events skipped before this page.
    - `order` string: Field the events are sorted by, for example `volume24hr`.
    - `source_url` string: URL the data was read from.
  - `msg` string

## Other responses

- `400`: Bad Request
- `429`: Too Many Requests
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/0497899e2016?raw)