Markets

Explore markets

Browse whale-active titled markets with category, platform, status, and keyword filters. Paginates visible discovery entries rather than raw market rows, returns live category/platform facets alongside grouped event clusters or standalone markets, and includes total on the first page only. Categories come straight from provider metadata (Polymarket Gamma, Kalshi) and facets are flat value/label/count rows.

get/api/v1/markets/explore

Query parameters

categorystring

Filter by market category (case-insensitive). A canonical bucket name (e.g. Basketball) matches every provider member that folds into it (NBA, WNBA, NCAAB); a raw provider value also resolves to its bucket. Facet values are returned as the canonical bucket.

status'active' | 'closed' | 'all'

Filter by market status.

platform'polymarket' | 'kalshi' | 'all'

Filter by source platform.

sort'trending' | 'hot' | 'expiring' | 'whales' | 'volume' | 'newest'

Sort order for the discovery feed.

cursorstring

Opaque pagination cursor from the previous response.

limitinteger

Page size.

qstring

Keyword search against market titles.

Headers

If-None-Matchstring

Conditional GET validator from a previous ETag. Matching values return 304 Not Modified with an empty body.

Response

Grouped market discovery results

object'list' required
has_moreboolean required
next_cursorstring nullable
totalinteger nullable

Total matching visible entries after grouping. Present on the first page and omitted on cursor pages.

Changes