Skip to main content
GET
Get Builder Stats
Single-builder summary over a rolling window, plus the full history of (taker_bps, maker_bps) rate changes for that builder.
V2-only. Builder attribution is a Polymarket V2 concept - V1 fills are excluded from all metrics.

Windows

24h, 7d (default), 30d, or all.

Fee-rate history

The fee_rate_history array returns every (taker_bps, maker_bps) rate the builder has used, in order, with valid_from and valid_to Unix timestamps. The current rate has a far-future valid_to.

Authorizations

x-api-key
string
header
required

Path Parameters

builder_code
string
required

Builder code (bytes32 hex)

Query Parameters

window
string
default:7d

Rolling window: 24h, 7d, 30d, or all

Response

Successful Response

Detailed stats for a single builder.

builder_code
string
required

Builder code, bytes32 hex

window
string
required

Time window for the rolling metrics

volume_usd
number
required
builder_fee_usd
number
required
platform_fee_usd
number
required
trade_count
integer
required
unique_traders
integer
required
unique_markets
integer
required
current_taker_bps
integer | null

Current taker bps

current_maker_bps
integer | null

Current maker bps

first_seen_at
integer | null

Unix timestamp of earliest attributed fill

last_seen_at
integer | null

Unix timestamp of latest attributed fill

fee_rate_history
BuilderFeeRateHistoryEntry · object[]