polymarket_events
Read-onlyIdempotent
Fetch event catalogs with nested prediction markets. Filter and sort by volume, liquidity, status, dates, or tags to compare market odds and identify active trading opportunities.
Instructions
Event catalogue (an event groups related markets, e.g. one game or election) with nested markets.
Returns: [{id, title, slug, description, volume, liquidity, endDate, tags, markets:[{id, question, clobTokenIds, outcomePrices}]}] (top-level array)
Example: Most-traded active events {"limit": 5, "active": true, "closed": false, "order": "volume24hr", "ascending": false}
Auth: none needed.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| slug | No | Exact event slug (e.g. from a polymarket.com/event/... URL). | |
| limit | No | Page size. | |
| order | No | Sort key (e.g. volume24hr, liquidity, endDate). | |
| active | No | Only active events. | |
| closed | No | Only (or exclude with false) closed events. | |
| offset | No | Pagination offset. | |
| tag_id | No | Filter by tag id. | |
| archived | No | Include archived. | |
| ascending | No | Sort direction. | |
| series_id | No | Filter by series id. | |
| volume_min | No | Min volume. | |
| end_date_max | No | ISO date — events ending before this. | |
| end_date_min | No | ISO date — events ending after this. | |
| liquidity_min | No | Min liquidity. |