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

> Builder rankings, fees, attributed activity, and analytics.

A builder is an app or integration that routes order flow to Polymarket under a builder code, earning fees on the volume it brings. The Builders endpoints cover rankings and metadata, fees, the traders and tags behind a builder's volume, retention and concentration, and both per-builder and global analytics.

## Discover

* [List builders ranked by activity](/api-reference/builders/list-builders-ranked-by-activity), [search by name or code](/api-reference/builders/search-builders-by-name-or-code), or [list builder metadata](/api-reference/builders/list-builder-metadata).
* [Get a single builder's cumulative stats](/api-reference/builders/get-a-single-builders-cumulative-stats) and [display metadata](/api-reference/builders/get-a-builders-display-metadata).

## Fees and attribution

* Read [builder fee rates](/api-reference/builders/get-builder-fee-rates) and their [history](/api-reference/builders/get-builder-fee-rate-history).
* See a builder's [top traders](/api-reference/builders/top-traders-for-a-builder), [per-tag breakdown](/api-reference/builders/per-tag-breakdown-for-a-builder), [trader-volume concentration](/api-reference/builders/trader-volume-concentration-for-a-builder), and [cohort retention](/api-reference/builders/cohort-retention-for-a-builder).
* [Bucket the top builders with an "other" composition](/api-reference/builders/bucketed-top-n-with-other-builder-composition).

## Per-builder analytics

* [Percentage change](/api-reference/builders/builder-percentage-change-over-a-lookback-window), [per-bucket deltas](/api-reference/builders/builder-analytics-deltas-per-bucket-change), and [cumulative timeseries](/api-reference/builders/builder-analytics-timeseries-cumulative).

## Across all builders

* [Cumulative stats](/api-reference/builders/cumulative-stats-across-all-builders), [percentage change](/api-reference/builders/percentage-change-across-all-builders-over-a-lookback-window), [per-bucket deltas](/api-reference/builders/per-bucket-deltas-across-all-builders), and [cumulative timeseries](/api-reference/builders/cumulative-bucket-timeseries-across-all-builders).
* [All tags with builder-attributed activity](/api-reference/builders/all-tags-with-builder-attributed-activity), and the [per-builder breakdown for a tag](/api-reference/builders/per-builder-breakdown-for-a-tag).

## Builder-attributed trades

* Pull the trades a builder routed by filtering [market trades](/api-reference/market/get-market-trades) on `builder_codes`.

## Example

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

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

  const { data: builders } = await client.builders.getBuilders({ limit: 25 });

  const { data: global } = await client.builders.getGlobal();
  ```

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

## Related

* Guides: [Fetching Trades by Builder Code](/guides/fetching-trades-by-builder-code), [Builder Revenue Dashboard](/guides/builder-revenue-dashboard)
* SDK: [REST namespaces](/sdk/rest-api)
* [Core concepts](/introduction/concepts)