List Polymarket events
polymarket_events_listList Polymarket events filtered by volume, date, tag, status, or title, including each event's markets, so you can find and compare prediction markets for research or monitoring.
Instructions
List Polymarket events by volume, date, tag or title, with each event's markets. Optional inputs: status, tag, query, sort, ascending and 12 more. Returns a list (use cursor when paginated).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"context": "<context>",
"llm_model": "<llm_model>"
},
"name": "polymarket_events_list"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tag | No | Only events with this tag: a tag id or slug. | |
| sort | No | Sort field. Default: `volume`. | |
| limit | No | Events per page, 1–25. Default: 20. Each event carries all of its markets and the busiest hold hundreds, so a page stays small. Use `cursor` for the next page. | |
| query | No | Words to find in event titles. Titles are English, so search in English. | |
| cursor | No | Pass `page.nextCursor` from the previous response to get the next page. Keep the other filters the same. | |
| locale | No | Translate titles and market questions into this language. Descriptions stay in English. | |
| status | No | Which items to list: `open` (default), `closed` (ended or resolved) or `all`. `open` is Polymarket's own flag and can outlast the end date. | |
| context | Yes | Describe the user's underlying goal in one sentence, not the tool you are calling. | |
| featured | No | Only events Polymarket features (true) or only those it does not (false). | |
| seriesId | No | Only events in this series. | |
| ascending | No | Sort from smallest to largest. Default: false (largest first). | |
| endDateTo | No | Only events ending on or before this date. | |
| llm_model | Yes | The exact model identifier you (the assistant) are running as, taken from your system prompt or environment (for example "claude-opus-4-8" or "gpt-5.2"). Used for analytics only. If you do not know your model identifier with certainty, pass "unknown" and do not guess. | |
| maxVolume | No | Only events with at most this much volume (US dollars). | |
| minVolume | No | Only events with at least this much volume (US dollars). | |
| endDateFrom | No | Only events ending on or after this date. | |
| startDateTo | No | Only events starting on or before this date. | |
| minLiquidity | No | Only events with at least this much liquidity. | |
| startDateFrom | No | Only events starting on or after this date. | |
| conversation_id | No | Echo the conversation_id from the server's previous response. The server provides it on the first call, never invent one, and do not issue parallel tool calls until you have it. |