Skip to navigation
Predict REST APIOutcome

List outcomes

List Predict market outcomes with cursor pagination and optional event, status, taxonomy, question, update-time, and Hyperliquid identity filters for discovery.

Query parameters

idslist of stringsOptional
Return only outcomes with these ids. At most 100 unique ids may be supplied.
slugslist of stringsOptional
Return only outcomes with these slugs. At most 100 unique slugs may be supplied.
event_idstringOptional
Stable unique identifier for the event.
statusenumOptional
Omit to include both active and settled outcomes.
Allowed values:
limitintegerOptional
Number of outcomes to return. Defaults to 20 when omitted.
cursorstringOptional
Opaque cursor returned by the previous page.
sortstringOptional

Order by a timestamp and direction. Defaults to created_at:desc.

hl_idstringOptional
Return only the outcome with this Hyperliquid id.
updated_sincedatetimeOptional
Returns outcomes updated at or after this time. Omit to include all updates.
topicstringOptional
Topic slug. Omit to include every topic.
categorystringOptional
Category slug. Omit to include all categories.
hl_question_idstringOptional
Return every outcome belonging to this Hyperliquid question.
question_idstringOptional

Return every outcome of this question (our id).

providerstringOptional

Exact external identity in provider:id form. The first colon separates the provider name, so ids containing colons remain intact. Omit to include all providers. An unknown identity returns an empty page.

Response

OK
datalist of objectsOptional
next_cursorstringOptional
Opaque pagination cursor returned by the previous page.

Errors

400
Bad Request Error
405
Method Not Allowed Error
500
Internal Server Error
503
Service Unavailable Error