Browse Polymarket event topics, descriptions and reported activity across requested pages. Choose a general list or supported filters, with child markets included only when requested.
Up to 0.01122 credits / call
The final charge is based on confirmed usage. Unused reserved credits return to your available balance.
BlockRun
Browse Polymarket Event Pages | BlockRun
Browse Polymarket event topics, descriptions and reported activity across requested pages. Choose a general list or supported filters, with child markets included only when requested.
You receive
Receive a page of Polymarket event records with titles, descriptions, reported statuses, dates and associated market counts. Provided statistics describe event-level volume, liquidity and open interest; optional inline child markets form a limited subset.
Your Agent can compare the context across requested pages while keeping each event’s identifiers, dates and missing values visible.
Start with your task
List a page of Polymarket events. Say what each is about and whether it is open or closed.
What to know
A page count is not the total number of matches. Further pages depend on the returned continuation key. Capped child lists may omit associated markets, and null does not mean there are none. Event status and dates do not establish final outcomes, current tradability or real-time freshness.
Inputs & outputs
Inspect the current inputs, availability, and maximum charge before starting.
Input schema
Input schema
Field / Path
Type
Requirement
Meaning
Event queryqueryParams
object
Optional
Optional container for flat event filters and pagination controls. A general first page does not need an event identifier or title phrase.
Nested query objectqueryParams.query
object
Optional
Optional generic object with no declared children. This endpoint’s documented controls belong directly in queryParams.
A nullable continuation value for the same query scope. Preserve it exactly rather than treating it as an event ID or page number.
Additional notes
Pages and query scope
Pagination count describes the current response, with no total count for all matches. The returned pagination_key is an opaque continuation reference for the same filters and sort; it is not a page number or an event identifier. Offset pagination has been removed, and only offset 0 is accepted. An event page can contain fewer records than the requested limit.
A general first page needs no selector. Optional status uses open or closed, search matches event titles with 3–100 characters, and id, slug or tag accept up to 50 strings each. Category follows the source vocabulary. The source declares sort options with created as the default, but does not fully define every ordering direction, tie rule or filter combination. An event limit is an integer from 1 to 100, defaulting to 20.
Children and event statistics
Inline child markets require include_markets=true; the default is false. Their markets_per_event cap is an integer from 1 to 50, defaulting to 10. The source describes these children as volume-sorted without identifying the precise volume window or direction. A capped child list and the event's reported market_count are separate; null is not evidence that the event has no associated markets.
min_volume is a nonnegative threshold for event volume over the last 7 days in USD. min_open_interest is a nonnegative threshold for current event open interest in USD. Keep both separate from total_volume_usd and liquidity_usd. Generic event rolling_metrics and series context retain their raw values; series statistics have their own scope, and no event-wide refresh cadence or leaf-value formula is established.
Dates and references
Nullable ISO 8601 start_date, end_date, creation_date and closed_time values describe different source fields. Keep unexpected values instead of relabelling them or deriving freshness. Event status is separate from a child's status and final outcome. If child outcomes are returned, their prices and winning-side values remain source data without an established currency, probability, complement or settlement formula.
You can view the list without choosing one event first. Each request shows one page, so it may not include every Polymarket event.
List a page of Polymarket events. Say what each is about and whether it is open or closed.
Understand the event list
One event can include several related questions. “Open” or “closed” describes the event, not the final answer to those questions. This page only shows information; it does not place a bet.
