Skip to main content
GET
/
v2
/
polymarket
/
events
Get Events
curl --request GET \
  --url https://api.predexon.com/v2/polymarket/events \
  --header 'x-api-key: <api-key>'
{
  "events": [
    {
      "id": "<string>",
      "ticker": "",
      "slug": "",
      "title": "",
      "description": "",
      "category": "",
      "tags": [
        {}
      ],
      "series": [
        {}
      ],
      "image_url": "",
      "icon_url": "",
      "resolution_source": "",
      "start_date": "<string>",
      "end_date": "<string>",
      "creation_date": "<string>",
      "closed_time": "<string>",
      "neg_risk": false,
      "neg_risk_market_id": "<string>",
      "enable_order_book": false,
      "status": "open"
    }
  ],
  "pagination": {
    "limit": 123,
    "offset": 123,
    "total": 123,
    "has_more": true
  }
}
Events are top-level groupings that contain one or more markets. Use status=open for active events only.
ConstraintValue
limit1–100 (default 20)
offsetNo limit

Authorizations

x-api-key
string
header
required

Query Parameters

status
enum<string> | null

Filter by status: open or closed

Available options:
open,
closed
category
string | null

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

search
string | null

Search in title (minimum 3 characters)

Required string length: 3 - 100
id
string[] | null

Filter by event ID(s)

Maximum array length: 50
slug
string[] | null

Filter by event slug(s)

Maximum array length: 50
tag
string[] | null

Filter by tag slug(s)

Maximum array length: 50
sort
enum<string>
default:created

Sort by

Available options:
created,
created_asc,
start_date,
start_date_asc,
end_date,
end_date_desc,
title,
relevance
limit
integer
default:20

Number of events to return

Required range: 1 <= x <= 100
offset
integer
default:0

Number of events to skip

Required range: 0 <= x <= 10000

Response

Successful Response

Response for Polymarket events list endpoint.

events
PolymarketEvent · object[]
required
pagination
OffsetPagination · object
required

Offset-based pagination for markets list endpoints.