Query parameters
tagstringqueryoptionalTop-level tag slug (e.g. crypto)
substringqueryoptionalSub-tag slug; a child of
tagqstringqueryoptionalTitle keyword
sortvolume24h | volume | liquidity | newest | endingSoonqueryoptionalInvalid enum → 400. Defaults to volume24h
statusactive | resolved | allqueryoptionalInvalid enum → 400. Defaults to active
limitintegerqueryoptionalPage size, default 20, clamped to 100 server-side
offsetintegerqueryoptionalOffset; very large values are silently clamped to 10000, yielding an empty page
Response
200One page of eventseventsobject(PxEventCard)[]Event cards on this page
eventIdstringEvent id
slugstringEvent slug
titlestringEvent title
imageUrlstringnullableCover image
iconUrlstringnullableIcon
negRiskbooleanWhether the event group is negRisk
activebooleanHas open markets; may be true together with closed
closedbooleanHas non-open markets; always true when a continuous series has historical rounds
stateOPEN | ENDED | UPCOMINGDisplay-only three-state. OPEN = has open markets; ENDED = has markets but none open; UPCOMING = no markets yet
endDateMsstringnullableCutoff as a millisecond string; continuous series align to the current round
volumeUsdE6stringTotal traded volume across the child markets, as an E6 string
volume24hUsdE6string24h traded volume across the child markets, as an E6 string
liquidityUsdE6stringTotal book liquidity across the child markets, as an E6 string
seriesIdstringnullableRolling-round series id; null for non-rolling events — the client picks its route from this
topMarketsobject(PxMarketSummary)[]Card hot markets: top 3 by 24h volume for regular events; continuous series contribute only the current round
marketIdstringEngine market id — this is the one to place orders with
eventIdstringParent event
questionstringMarket question
slugstringMarket slug
groupItemTitlestringnullableShort title within the group; null when ungrouped
outcomeALabelstringYES side display text (not YES itself)
outcomeBLabelstringNO side display text
statusstringCatalog-side market state; typically OPEN or RESOLVED
resolutionstringnullableResolution YES/NO etc.; null or UNRESOLVED when unresolved
priceTickE6stringnullableTick size, as an E6 string
minOrderSizeE6stringnullableMinimum order size, as an E6 string
outcomeAPriceE6stringnullableLatest YES-side price, as an E6 string (600000 = 0.60)
outcomeBPriceE6stringnullableLatest NO-side price, as an E6 string
volume24hUsdE6stringnullable24h traded volume, as an E6 string
volumeUsdE6stringnullableLifetime traded volume, as an E6 string
liquidityUsdE6stringnullableBook liquidity, as an E6 string
endDateMsstringnullableClose time, as a millisecond string
hasBooksbooleanWhether a book exists
iconUrlstringnullableIcon URL
oneDayPriceChangestringnullable24h change for display (e.g. 0.100) — not a fixed-point integer
nextOffsetint64nullableNext-page offset; null = no next page (JSON number / null, not a string)
Switch status codes in the response example to view errors. For all codes, see the Errors page.
