Skip to main content
GET
List markets

Authorizations

X-API-Key
string
header
required

Query Parameters

Optional case-insensitive text match for market question or slug.

Maximum string length: 200
Example:

"trump"

limit
integer
default:100

Maximum number of items returned in this page.

Required range: 1 <= x <= 1000
Example:

100

cursor
string

Opaque cursor from a previous metadata.next_cursor value.

event_id
string

Optional filter to only markets belonging to this event (by internal event id).

Example:

"e_abc123"

event_slug
string

Optional filter to only markets belonging to this event (by event slug).

Example:

"bitcoin-hits-a-million"

include_closed
boolean
default:false

When true, include closed markets. Defaults to open (active) markets only.

sort
enum<string>
default:updated_at

Field used to sort the response rows.

Available options:
updated_at,
start_date,
end_date
order
enum<string>
default:desc

Sort direction.

Available options:
asc,
desc

Response

Paginated list of markets.

Paginated response for GET /markets.

metadata
PaginationMetadata · object

Pagination metadata.

data
MarketItem · object[]

Market results for this page.