Events

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

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

Query Parameters

integer

default:"50"

Results per page (1–500).

integer

Offset for pagination. When provided, cursor parameters are ignored.

integer

Unix timestamp in milliseconds from the next object of a previous response.

integer

Event ID from the next object of a previous response.

Response Fields

Field	Type	Description
`id`	integer	Event ID
`title`	string	Event title
`slug`	string	URL-safe slug
`description`	string	Event description
`categories`	string	Event categories
`created_at`	string	ISO 8601 creation timestamp
`start_date`	string	ISO 8601 start timestamp
`end_date`	string	ISO 8601 end timestamp
`active`	boolean	Whether the event is active
`closed`	boolean	Whether the event is closed
`archived`	boolean	Whether the event is archived
`volume`	number	Total trading volume
`liquidity`	number	Current liquidity
`open_interest`	number	Open interest
`comment_count`	integer	Number 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

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

Query Parameters

string

required

Search query (uses PostgreSQL websearch_to_tsquery).

integer

default:"50"

Results per page (1–500).

boolean

Filter by active status.

boolean

Filter by closed status.

boolean

Filter by archived status.

integer

Cursor for pagination (from next object).

integer

Cursor for pagination (from next object).

Response Fields

Returns the same event fields as the list endpoint, plus:

Field	Type	Description
`market_ids`	string[]	Array of market ID strings belonging to this event
`market_count`	integer	Number 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 a single event by ID. Returns all fields from the events table.

Path Parameters

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 all markets belonging to an event.

Path Parameters

integer

required

Event ID.

Query Parameters

integer

default:"100"

Results per page (1–1000).

integer

Offset for pagination.

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
  }
}

Overview

Endpoints

List Events

Query Parameters

Response Fields

Example

Search Events

Query Parameters

Response Fields

Examples

Get Event

Path Parameters

Example

Get Event Markets

Path Parameters

Query Parameters

Example

​List Events

​Query Parameters

​Response Fields

​Example

​Search Events

​Query Parameters

​Response Fields

​Examples

​Get Event

​Path Parameters

​Example

​Get Event Markets

​Path Parameters

​Query Parameters

​Example

List Events

Query Parameters

Response Fields

Example

Search Events

Query Parameters

Response Fields

Examples

Get Event

Path Parameters

Example

Get Event Markets

Path Parameters

Query Parameters

Example