# Polymarket Events Browser via 2s.io

> Polymarket Events Browser via 2s.io is a paid API for AI agents from 2s.io, paid per call via x402, $0.012/call, status unknown (last checked 2026-09-15).

Browse and search Polymarket prediction market events with live outcome prices, volumes, liquidity, and nested market data

## Facts

- Endpoint: GET https://2s.io/api/predict/events
- Price: $0.012/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/polymarket-events-browser-via-2s-io-a6b27a74
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_B9xkJIwZyeWzQUu1o-gOs

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 polymarket-events-browser-via-2s-io-a6b27a74
```

Example prompt: Pull up the top 20 Polymarket events about the 2024 US election sorted by 24-hour volume, and show me the live implied probabilities for each outcome.

## When to prefer this

Use this endpoint when you need live Polymarket prediction market data including event browsing, keyword search, volume/liquidity ranking, or fetching nested market outcome prices and CLOB token ids. Prefer over direct Polymarket API access when you need pay-per-call simplicity via x402.

## Known failure modes

- Invalid order enum value returns 400 error
- offset beyond available results returns empty list
- q keyword with no matching events returns empty array
- limit exceeding 100 rejected with validation error
- API unavailable or Polymarket Gamma outage returns 5xx

## How this service works

Browse Polymarket events (an event groups related markets — e.g. an election, a tournament, a price ladder). Optional keyword q, closed filter, order (volume/volume24hr/liquidity), and limit/offset. Each event returns its title, tags, USD volume + 24h volume, liquidity, dates, and the nested markets with their outcomes + live outcome prices (implied probabilities) and CLOB token ids. Read-only mirror of Polymarket's Gamma events.

## Output

Returns a list of Polymarket events, each with title, tags, total USD volume, 24h volume, liquidity, start and end dates, and nested markets containing their outcomes, live outcome prices (implied probabilities), and CLOB token ids for trading.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "queryParams"
   ],
   "properties": {
    "type": {
     "const": "http"
    },
    "method": {
     "const": "GET"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "q": {
       "type": "string",
       "maxLength": 120,
       "description": "Keyword filter on event title/description."
      },
      "limit": {
       "type": "integer",
       "maximum": 100,
       "minimum": 1
      },
      "order": {
       "enum": [
        "volume",
        "volume24hr",
        "liquidity",
        "startDate",
        "endDate"
       ],
       "type": "string"
      },
      "closed": {
       "type": "boolean"
      },
      "offset": {
       "type": "integer",
       "minimum": 0
      }
     },
     "additionalProperties": false
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/polymarket-events-browser-via-2s-io-a6b27a74/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 2s.io](https://www.zero.xyz/host/2s.io/llms.txt)