API Reference

List Events

Public: List events with their markets (event-first data structure).

This endpoint provides the Polymarket-style event->markets hierarchy, preserving the grouping from the Gamma API. Each event contains:

Query params:

limit: Max events to return (default 50)
offset: Pagination offset
hot_only: Only return events with significant volume
markets_per_event: Max markets per event (default 20, for bandwidth)
category: Filter by detected category (Sports, Politics, Crypto, etc.)
search: Text search in event titles and market questions (searches sports too)
include_sports: Whether to include sports games in search results (default true)

GET

events

List Events

curl --request GET \
  --url https://staging-api.polysimulator.com/events

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

limit

integer

default:50

offset

integer

default:0

hot_only

boolean

default:false

markets_per_event

integer

default:20

Successful Response

⌘I

List Events

curl --request GET \
  --url https://staging-api.polysimulator.com/events

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}