Skip to main content
Retrieve a list of prediction market events. You can filter by category, tag, search term, currency mode, status, and date range. This endpoint does not require authentication.

Endpoint

Authentication

This endpoint does not require authentication. Public event data is accessible without HMAC headers.

Parameters

Case-insensitive search across the event title, market names, categories, and tags. Maximum 100 characters.
string
default:"play_money"
Filter by currency mode: play_money or real_money. Defaults to play_money.
string
Comma-separated category IDs. A root category includes its descendants. An event matches any listed category.
string
Comma-separated category slugs, as an alternative to categories. A root slug includes its descendants. An event matches any listed slug. When categories is also set, the event must match both.
string
Comma-separated tag slug or name, up to 10. An event matches if it has any listed tag. Matching is case-insensitive.
boolean
default:"false"
When true, return events that are live now or start within 12 hours.
boolean
default:"false"
When true, return only resolved events.
boolean
default:"false"
When true, return unresolved events whose close time has passed.
string
Inclusive lower bound for bet_end_date, ISO 8601 with a timezone (for example 2026-11-01T00:00:00Z). Events without bet_end_date are excluded. Combines with the list status window: open and pending resolution, unless live, resolved_only, or pending_resolution is set.
string
Inclusive upper bound for bet_end_date, ISO 8601 with a timezone (for example 2026-11-01T00:00:00Z). Events without bet_end_date are excluded. Combines with the list status window: open and pending resolution, unless live, resolved_only, or pending_resolution is set.
boolean
default:"false"
Authenticated only. Omit events the user has already bet on.
boolean
default:"false"
Authenticated only. Return events the user follows.
string
Field to order results by. Allowed values: relevance, -relevance, created_on, -created_on, bet_end_date, -bet_end_date, wagers_count, -wagers_count, volume, -volume, open_date, -open_date, resolve_date, -resolve_date. Prefix with - for descending order.
integer
Number of results to return per page.
integer
The initial index from which to return the results.

Response

Returns a paginated list of event objects.
integer
required
Total number of events matching the query.
string
URL to the next page of results, or null if there are no more pages.
string
URL to the previous page of results, or null if on the first page.
array
required
Array of event objects.

Event object

integer
required
Unique event ID.
string
required
The event title or question.
array
required
Array of market objects representing possible outcomes for this event.
string
ISO 8601 timestamp when betting closes, or null if not set.
string
ISO 8601 timestamp when the event was created.

Example

Sample response