Skip to main content
GET
List markets for a page
The id parameter can be __home__ to list all markets when Home is not explicitly configured.Supports both offset pagination (page + limit) and cursor pagination (cursor). When cursor is present, offset pagination is ignored.Sorting: prefix field with - for descending (e.g., -updatedAt). Allowed fields: createdAt, updatedAt, deadline, id.
includeNextMarket (optional). Pass includeNextMarket=true to attach the next round of upfront-scheduled markets to each affected result:
Use this to prefetch or subscribe to the successor before the current round expires. During the short activation gap between rounds, the expired predecessor stays in the list so the series is represented by exactly one row at all times.Cursor tokens embed this option — do not toggle includeNextMarket mid-pagination. The tradable flag is conservative in listings; fetch the successor directly with Get Market before trading.

Path Parameters

id
string
required

Market page ID

Example:

"123e4567-e89b-12d3-a456-426614174000"

Query Parameters

Response

Markets retrieved successfully

data
string[]
required

Array of market/group data

cursor
object

Cursor pagination info (when using cursor parameter)

pagination
object

Offset pagination info (when using page parameter)

counts
object

Counts per tab option for the active filter context

Example: