Skip to main content
Events are the top-level containers for related markets. For example, “2024 Presidential Election” is an event that contains multiple markets like “Will candidate A win?” and “Will candidate B win?”.

​
List Events

​
GET
List all events, ordered by end date.

​
Query Parameters

​
limit
integer
default:"50"
Results per page (1-500)
​
offset
integer
Offset for pagination
​
cursor_end_date
integer
Unix timestamp in milliseconds from previous response
​
cursor_id
integer
Event ID from previous response

​
Example

curl "https://poly-data.xyz/events?limit=20"
Response: 
{
  "limit": 20,
  "count": 20,
  "next": {
    "cursor_end_date": 1735689600000,
    "cursor_id": 500
  },
  "data": [
    {
      "id": 101,
      "title": "2024 Presidential Election",
      "slug": "2024-presidential-election",
      "volume": 15000000,
      "market_ids": ["5001", "5002", "5003"],
      "market_count": 3
    }
  ]
}

​
Search Events

​
GET
Search events by text query.

​
Query Parameters

​
q
string
required
Search query
​
limit
integer
default:"50"
Results per page (1-500)
​
active
boolean
Filter by active status
​
closed
boolean
Filter by closed status
​
archived
boolean
Filter by archived status
​
cursor_end_date
integer
Cursor for pagination
​
cursor_id
integer
Cursor for pagination

​
Examples

Search for crypto-related events: 
curl "https://poly-data.xyz/events/search?q=bitcoin"
Search for active sports events only: 
curl "https://poly-data.xyz/events/search?q=superbowl&active=true&closed=false"
Response: 
{
  "q": "bitcoin",
  "filters": {
    "active": null,
    "closed": null,
    "archived": null
  },
  "limit": 50,
  "count": 12,
  "next": null,
  "data": [
    {
      "id": 205,
      "title": "Bitcoin Price Milestones",
      "slug": "bitcoin-price-milestones",
      "volume": 8500000,
      "market_ids": ["6001", "6002"],
      "market_count": 2
    }
  ]
}

​
Get Event

​
GET
Get a single event by ID.

​
Path Parameters

​
id
integer
required
Event ID

​
Example

curl "https://poly-data.xyz/events/101"
Response: 
{
  "id": 101,
  "title": "2024 Presidential Election",
  "slug": "2024-presidential-election",
  "description": "Markets for the 2024 US Presidential Election",
  "volume": 15000000,
  "market_ids": ["5001", "5002", "5003"],
  "market_count": 3,
  "active": true,
  "closed": false,
  "archived": false
}

​
Get Event Markets

​
GET
Get all markets belonging to an event.

​
Path Parameters

​
id
integer
required
Event ID

​
Query Parameters

​
limit
integer
default:"100"
Results per page (1-1000)
​
offset
integer
Offset for pagination
​
cursor_id
integer
Market ID cursor for pagination

​
Example

curl "https://poly-data.xyz/events/101/markets?limit=50"
Response: 
{
  "event_id": "101",
  "limit": 50,
  "data": [
    {
      "id": 5001,
      "event_id": 101,
      "question": "Will candidate A win?",
      "volume_24h": 250000,
      "liquidity": 500000,
      "active": true,
      "closed": false
    },
    {
      "id": 5002,
      "event_id": 101,
      "question": "Will candidate B win?",
      "volume_24h": 180000,
      "liquidity": 420000,
      "active": true,
      "closed": false
    }
  ],
  "next": null
}