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

> Browse market categories, category leaders, and per-tag analytics.

A tag is a category that groups markets and events by theme, such as politics, crypto, or sports. The Tags endpoints list the available tags, fetch a single tag, surface the top traders within a category, and expose per-tag analytics.

## Browse

* [List every tag](/api-reference/tags/get-tags), or [fetch a single tag by slug](/api-reference/tags/get-tag-by-slug).

## Category leaders

* [Find the top traders within a category](/api-reference/tags/get-top-traders-for-a-category).

## Analytics

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

## Filter by tag

* Use a tag to filter [markets](/api-reference/market/get-markets) and [events](/api-reference/events/get-events) down to a category.

## Example

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

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

  const { data: tags } = await client.tags.getTags();

  const { data: tag } = await client.tags.getTag({ identifier: "politics" });
  ```

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

## Related

* SDK: [Tags namespace](/sdk/rest-api#tags)
* [Core concepts](/introduction/concepts)