# Polymarket Events List

> Polymarket Events List is a paid API for AI agents from polymarketeer.vercel.app, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-16).

Lists Polymarket prediction market events with filtering by status, category, and trading volume

## Facts

- Endpoint: POST https://polymarketeer.vercel.app/api/x402/polymarket/events
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/polymarketeer-vercel-app-0c46de59
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_z4oE_q81e_R0ohImRty0u

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability polymarketeer-vercel-app-0c46de59 -d '<json body>'
```

Example prompt: Show me a list of active Polymarket events in the politics category, sorted by highest trading volume.

## When to prefer this

Use this endpoint when you need to browse or enumerate multiple Polymarket events at once, especially when filtering by status (active/resolved/closed), category/topic, or minimum trading volume. Prefer this over the search endpoint when you want broad discovery rather than keyword-based lookup, and prefer it over individual event detail endpoints when you need a list rather than deep info on a single event.

## Known failure modes

- Invalid status filter value returns 400 error
- Unknown category/tag returns empty result set
- Payment of 0.01 USDC not provided returns 402 Payment Required
- Rate limiting or server overload returns 503
- Network timeout on Polymarket data source returns 504

## How this service works

List Polymarket events with filtering by status, category, and volume

## Output

A list of Polymarket events matching the specified filters, including event titles, slugs, statuses, categories/tags, and trading volume figures for each event.

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "data"
 ],
 "properties": {
  "data": {},
  "error": {
   "type": "string"
  }
 },
 "additionalProperties": false
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/polymarketeer-vercel-app-0c46de59/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from polymarketeer.vercel.app](https://www.zero.xyz/host/polymarketeer.vercel.app/llms.txt)