Get Events

Changed on Nov 3, 2026

Fetches events (groups of related markets) with optional filtering by event_slug, tags/categories and status. Events aggregate multiple markets under a single topic (e.g., 'Presidential Election 2024' contains multiple candidate markets). Returns events ordered by total volume (most popular first).

Example Request (single event by slug):

curl 'https://api.domeapi.io/v1/polymarket/events?event_slug=presidential-election-winner-2024&include_markets=true'

Example Request (filter by tags):

curl 'https://api.domeapi.io/v1/polymarket/events?tags=sports&status=open&limit=10'

Example Request (with markets included):

curl 'https://api.domeapi.io/v1/polymarket/events?include_markets=true&limit=5'

get/polymarket/events

Request

Base URL
https://api.domeapi.io/v1
Auth
none declared

Query parameters

event_slugstring

Example:presidential-election-winner-2024

Filter by specific event slug. When provided, returns a single hydrated event matching that slug (e.g., 'presidential-election-winner-2024'). Use with include_markets=true to get the full event with all its markets.

tagsstring[]

Filter events by tag(s)/category. Can provide multiple values (e.g., sports, crypto, politics).

[
  "sports",
  "football"
]

status'open' | 'closed'

Example:open

Filter events by status. An event is 'open' if any of its markets are still open, 'closed' if all markets are closed.

include_markets'true' | 'false'

Example:true

Set to 'true' to include the list of markets for each event in the response.

start_timeinteger

Example:1640995200

Filter events starting after this Unix timestamp (seconds)

end_timeinteger

Example:1672531200

Filter events starting before this Unix timestamp (seconds)

game_start_timeinteger

Example:1704067200

Filter events by game start time (Unix timestamp in seconds). Useful for filtering sports events by when the game starts.

limitinteger

Example:10

Number of events to return (1-100). Default: 10.

pagination_keystring

Example:eyJsYXN0Vm9sdW1lIjoxNzEyMTMyNjYzLjk2MTYwNjMsImxhc3RFdmVudFNsdWciOiJuYmEtY2hhbXBpb24tMjAyNC0yMDI1In0=

Pagination key for cursor-based pagination. Use the value from the previous response's pagination.pagination_key field to get the next page of results. Do not use the deprecated 'offset' parameter.

Response

Events response with pagination

Example response

{
  "events": [
    {
      "event_slug": "presidential-election-winner-2024",
      "title": "Presidential Election Winner 2024",
      "subtitle": "Who will win the 2024 US Presidential Election?",
      "status": "closed",
      "start_time": 1704067200,
      "end_time": 1730851200,
      "volume_fiat_amount": 3686335059.29,
      "settlement_sources": "Associated Press",
      "image": "https://polymarket.com/images/election-2024.png",
      "tags": [
        "politics",
        "elections"
      ],
      "market_count": 17,
      "markets": [
        {
          "market_slug": "will-trump-win-2024",
          "title": "Will Trump win the 2024 election?",
          "condition_id": "0x1234...",
          "status": "closed",
          "volume_total": 1500000000
        }
      ]
    }
  ],
  "pagination": {
    "limit": 10,
    "has_more": true,
    "pagination_key": "eyJsYXN0Vm9sdW1lIjoxNzEyMTMyNjYzLjk2MTYwNjMsImxhc3RFdmVudFNsdWciOiJuYmEtY2hhbXBpb24tMjAyNC0yMDI1In0="
  }
}

Changes

Nov 3, 2026103eb234470e Revision changes
- info
  api operation id getEvents was added
- info
  added the new optional query request parameter end_time
- info
  added the new optional query request parameter event_slug
- info
  added the new optional query request parameter game_start_time
- info
  added the new optional query request parameter include_markets
- info
  added the new optional query request parameter limit
- info
  added the new optional query request parameter pagination_key
- info
  added the new optional query request parameter start_time
- info
  added the new optional query request parameter status
- info
  added the new optional query request parameter tags
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the success response with the status

Operation history