v1

latestOpenAPI 3.1.02026-07-2359362475.0 KB
Prediction Markets

Get Prediction Market Event Screener

Browse and filter Polymarket events (groups of related markets). Includes aggregated volume, liquidity, and trader counts across all markets in each event.

What it helps to answer:

  1. What are the most popular prediction market events?
  2. How much total volume does an event have across all its markets?
  3. Which events have the most active trading?
post/api/v1/prediction-market/event-screener

Request body

sort_by'volume_24hr' | 'volume' | 'volume_1wk' | 'volume_1mo' | 'liquidity' | 'open_interest' | 'unique_traders_24h' | 'age_hours'

Valid sort fields for screener endpoints.

querystring

Search query to filter results

status'active' | 'closed' | ''

Valid status filters for screener endpoints.

tagsstring[]

Filter by tags

min_liquiditynumber

Minimum liquidity filter (-1 = no filter)

max_liquiditynumber

Maximum liquidity filter (-1 = no limit)

max_unique_traders_24hinteger

Maximum unique traders in 24h (-1 = no limit)

min_volume_24hrnumber

Minimum 24h volume filter (-1 = no filter)

neg_riskboolean

Filter by neg-risk framework (null = no filter)

min_open_interestnumber

Minimum open interest filter (-1 = no filter)

max_open_interestnumber

Maximum open interest filter (-1 = no limit)

end_date_beforestring

Filter markets ending before this datetime (ISO 8601)

end_date_afterstring

Filter markets ending after this datetime (ISO 8601)

Response

Event screener data