Polymarket Events API

An event groups related markets under a single theme, such as an election or a tournament. Events are identified by an event_slug or a numeric id. The Events endpoints cover discovery, the markets and outcomes that make up an event, charts, metrics, and per-event analytics.

Discover

List and filter events.
Fetch a single event by ID or slug or by slug.

Structure and metrics

Analytics

Per-event percentage change, per-bucket candles, and cumulative timeseries.

Holders and series

See who holds an event’s markets over time with event holders history.
Events can belong to a recurring series: list or get series, a series’ events, and series market outcomes.

Example

import { StructClient } from "@structbuild/sdk";

const client = new StructClient({ apiKey: "YOUR_API_KEY" });

const { data: event } = await client.events.getEventBySlug({ slug: "us-election-2028" });

const { data: metrics } = await client.events.getEventMetrics({
  event_slug: "us-election-2028",
  timeframe: "24h",
});

Guide: Real-Time Trending Events and Markets
SDK: Events namespace
Core concepts

​Discover

​Structure and metrics

​Analytics

​Holders and series

​Example

​Related

Discover

Structure and metrics

Analytics

Holders and series

Example

Related