> ## 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 Analytics API

> Global, platform-wide aggregates across all of Polymarket.

The Analytics endpoints return global, platform-wide aggregates across all of Polymarket: snapshot counts, percentage changes over a lookback window, per-bucket deltas (candles), and cumulative timeseries. For analytics scoped to a single market, event, trader, tag, or builder, use the analytics endpoints inside those groups.

## Global aggregates

* [Get a global analytics snapshot](/api-reference/analytics/global-analytics-snapshot) of current platform counts.
* Measure platform-wide [percentage change](/api-reference/analytics/global-analytics-pct-change), [per-bucket candles](/api-reference/analytics/global-analytics-candles-per-bucket-deltas), and [cumulative timeseries](/api-reference/analytics/global-analytics-timeseries-cumulative).

## Example

<CodeGroup>
  ```typescript SDK theme={null}
  import { StructClient } from "@structbuild/sdk";

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

  const { data: counts } = await client.analytics.getCounts();
  ```

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

<Note>Need analytics for a single entity? Use the per-entity analytics endpoints: [market analytics](/api-reference/market/market-analytics-pct-change), [event analytics](/api-reference/events/event-analytics-pct-change), [trader analytics](/api-reference/trader/trader-analytics-pct-change), [tag analytics](/api-reference/tags/tag-analytics-pct-change), and [builder analytics](/api-reference/builders/builder-percentage-change-over-a-lookback-window).</Note>

## Related

* Guide: [Finding Market Movers](/guides/finding-market-movers)
* SDK: [REST namespaces](/sdk/rest-api)
* [Core concepts](/introduction/concepts)