Skip to main content
Events are the top-level containers for related markets. For example, “Eintracht Frankfurt vs. BV Borussia 09 Dortmund” is an event that contains multiple markets like “Will Eintracht Frankfurt win?” and “Draw?”.

​
List Events

​
GET
List all events, ordered by end date (ascending, nulls last).

​
Query Parameters

​
limit
integer
default:"50"
Results per page (1–500).
​
offset
integer
Offset for pagination. When provided, cursor parameters are ignored.
​
cursor_end_date
integer
Unix timestamp in milliseconds from the next object of a previous response.
​
cursor_id
integer
Event ID from the next object of a previous response.

​
Response Fields

FieldTypeDescription
idintegerEvent ID
titlestringEvent title
slugstringURL-safe slug
descriptionstringEvent description
categoriesstringEvent categories
created_atstringISO 8601 creation timestamp
start_datestringISO 8601 start timestamp
end_datestringISO 8601 end timestamp
activebooleanWhether the event is active
closedbooleanWhether the event is closed
archivedbooleanWhether the event is archived
volumenumberTotal trading volume
liquiditynumberCurrent liquidity
open_interestnumberOpen interest
comment_countintegerNumber of comments
The list endpoint does not include market_ids or market_count. Use the search endpoint or event markets endpoint to get associated markets.

​
Example

curl "http://api.poly-data.xyz/events?limit=3"
Response (cursor-based): 
{
  "limit": 3,
  "data": [
    {
      "id": 126261,
      "title": "Eintracht Frankfurt vs. BV Borussia 09 Dortmund",
      "slug": "eintracht-frankfurt-vs-bv-borussia-09-dortmund",
      "description": "...",
      "categories": "sports",
      "created_at": "2025-12-27T05:00:04.093Z",
      "start_date": "2026-01-09T19:30:00.000Z",
      "end_date": "2026-01-09T19:30:00.000Z",
      "active": true,
      "closed": false,
      "archived": false,
      "volume": 1459190.209213,
      "liquidity": 500000,
      "open_interest": 250000,
      "comment_count": 12
    }
  ],
  "next": {
    "cursor_end_date": 1736448600000,
    "cursor_id": 126261
  }
}
Response (offset-based): 
{
  "limit": 3,
  "offset": 0,
  "data": [ ... ]
}

​
Search Events

​
GET
Full-text search over event titles, slugs, and descriptions. Returns matching events with their associated market IDs.

​
Query Parameters

​
q
string
required
Search query (uses PostgreSQL websearch_to_tsquery).
​
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 (from next object).
​
cursor_id
integer
Cursor for pagination (from next object).

​
Response Fields

Returns the same event fields as the list endpoint, plus:
FieldTypeDescription
market_idsstring[]Array of market ID strings belonging to this event
market_countintegerNumber of markets in this event

​
Examples

Search for Bundesliga events: 
curl "http://api.poly-data.xyz/events/search?q=bundesliga"
Search for active, non-closed events: 
curl "http://api.poly-data.xyz/events/search?q=bundesliga&active=true&closed=false"
Response: 
{
  "q": "bundesliga",
  "filters": {
    "active": null,
    "closed": null,
    "archived": null
  },
  "limit": 50,
  "count": 50,
  "next": {
    "cursor_end_date": 1737118200000,
    "cursor_id": 130200
  },
  "data": [
    {
      "id": 126261,
      "title": "Eintracht Frankfurt vs. BV Borussia 09 Dortmund",
      "slug": "eintracht-frankfurt-vs-bv-borussia-09-dortmund",
      "description": "...",
      "categories": "sports",
      "created_at": "2025-12-27T05:00:04.093Z",
      "start_date": "2026-01-09T19:30:00.000Z",
      "end_date": "2026-01-09T19:30:00.000Z",
      "active": true,
      "closed": false,
      "archived": false,
      "volume": 1459190.209213,
      "liquidity": 500000,
      "open_interest": 250000,
      "comment_count": 12,
      "market_ids": ["1034460", "1034462", "1034464"],
      "market_count": 3
    }
  ]
}

​
Get Event

​
GET
Get a single event by ID. Returns all fields from the events table.

​
Path Parameters

​
id
integer
required
Event ID.

​
Example

curl "http://api.poly-data.xyz/events/126261"
Response: 
{
  "id": 126261,
  "title": "Eintracht Frankfurt vs. BV Borussia 09 Dortmund",
  "slug": "eintracht-frankfurt-vs-bv-borussia-09-dortmund",
  "description": "...",
  "categories": "sports",
  "created_at": "2025-12-27T05:00:04.093Z",
  "start_date": "2026-01-09T19:30:00.000Z",
  "end_date": "2026-01-09T19:30:00.000Z",
  "active": true,
  "closed": false,
  "archived": false,
  "volume": 1459190.209213,
  "liquidity": 500000,
  "open_interest": 250000,
  "comment_count": 12
}

​
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 "http://api.poly-data.xyz/events/126261/markets"
Response: 
{
  "event_id": "126261",
  "limit": 100,
  "data": [
    {
      "id": 1034460,
      "event_id": 126261,
      "question": "Will Eintracht Frankfurt win on 2026-01-09?",
      "slug": "bun-ein-dor-2026-01-09-ein",
      "description": "...",
      "created_at": "2025-12-27T05:00:04.093Z",
      "start_date": "2025-12-27T05:13:00.407Z",
      "end_date": "2026-01-09T19:30:00.000Z",
      "deploying_timestamp": "2025-12-27T05:00:55.483Z",
      "active": true,
      "closed": false,
      "archived": false,
      "ready": false,
      "funded": false,
      "accepting_orders": true,
      "neg_risk": true,
      "volume_24h": "225160.59",
      "volume_total": "231175.94",
      "liquidity": "438058.03",
      "order_min_size": "5",
      "order_price_min_tick_size": "0.001"
    }
  ],
  "next": {
    "cursor_id": 1034460
  }
}