> ## Documentation Index
> Fetch the complete documentation index at: https://docs.struct.to/llms.txt
> Use this file to discover all available pages before exploring further.

# Polymarket Events API

> Event discovery, structure, charts, and per-event analytics on Polymarket.

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](/api-reference/events/get-events).
* Fetch a single event [by ID or slug](/api-reference/events/get-event-by-id-or-slug) or [by slug](/api-reference/events/get-event-by-slug).

## Structure and metrics

* [List an event's market outcomes](/api-reference/events/get-event-market-outcomes).
* [Get an event price chart](/api-reference/events/get-event-chart) and [aggregate event metrics](/api-reference/events/get-event-metrics).

## Analytics

* Per-event [percentage change](/api-reference/events/event-analytics-pct-change), [per-bucket candles](/api-reference/events/event-analytics-candles-per-bucket-deltas), and [cumulative timeseries](/api-reference/events/event-analytics-timeseries-cumulative).

## Holders and series

* See who holds an event's markets over time with [event holders history](/api-reference/holders/get-event-holders-history).
* Events can belong to a recurring series: [list or get series](/api-reference/series/list-or-get-series), [a series' events](/api-reference/series/get-series-events), and [series market outcomes](/api-reference/series/get-series-market-outcomes).

## Example

<CodeGroup>
  ```typescript SDK theme={null}
  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",
  });
  ```

  ```bash cURL theme={null}
  curl "https://api.struct.to/v1/polymarket/events/slug/us-election-2028" \
    -H "X-API-Key: YOUR_API_KEY"
  ```
</CodeGroup>

## Related

* Guide: [Real-Time Trending Events and Markets](/guides/real-time-trending-events-and-markets)
* SDK: [Events namespace](/sdk/rest-api#events)
* [Core concepts](/introduction/concepts)