Polymarket Builders API

​

Discover

• List builders ranked by activity, search by name or code, or list builder metadata.
• Get a single builder’s cumulative stats and display metadata.

​

Fees and attribution

• Read builder fee rates and their history.
• See a builder’s top traders, per-tag breakdown, trader-volume concentration, and cohort retention.
• Bucket the top builders with an “other” composition.

​

Per-builder analytics

• Percentage change, per-bucket deltas, and cumulative timeseries.

​

Across all builders

• Cumulative stats, percentage change, per-bucket deltas, and cumulative timeseries.
• All tags with builder-attributed activity, and the per-builder breakdown for a tag.

​

Builder-attributed trades

• Pull the trades a builder routed by filtering market trades on builder_codes.

​

Example

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();

​

Related

• Guides: Fetching Trades by Builder Code, Builder Revenue Dashboard
• SDK: REST namespaces
• Core concepts