Events & Markets

List events

Events with their markets nested, one page at a time.

GET/venues/{venue}/eventsself-hosted · no auth

Self-hosted. Served by synpath serve on your own machine or host, which must be running. Nothing on this page runs on Synpath's servers.

An event is a real-world question; its markets are the propositions under it. Search is server-side on every venue and ranked by relevance, so paging deep into a large result set is best effort. To enumerate everything, walk without query.

Path parameters

Name	Type	Description
`venue`	`string`	Venue id: `kalshi`, `polymarket` or `polymarket_us`.

Query parameters

Name	Type	Description
`query`	`string`	Text filter. Server-side on every venue, ranked by relevance.
`limit`	`integer` default 100	Rows per page, up to 100.
`cursor`	`string`	Opaque cursor from a previous `next_cursor`. There is no offset: the set changes between calls.
`status`	`string` default open	`unopened`, `open`, `closed` or `settled`. Polymarket cannot filter by `settled`.

Response

A page of events. Each market inside is a full Market object.

import synpath

venue = synpath.exchange("polymarket")
page = venue.fetch_events(query="fed", limit=10)
for event in page:
    print(event.id, event.title, len(event.markets))
page.next_cursor              # pass back as cursor=

200

{
  "data": [
    {
      "id": "kalshi:KXELONMARS-99",
      "title": "Will Elon Musk visit Mars before Aug 1, 2099?",
      "markets": [
        "..."
      ],
      "...": "a full Event"
    }
  ],
  "next_cursor": "eyJjIjoiQ0RJIiwibyI6NX0",
  "count": 1
}

← Get venue

List markets →