Skip to main content
GET
Get Wallet Builder Fees
Total builder fees a single wallet has paid over a rolling window, plus a per-builder breakdown. Each fill is scored at the (taker_bps, maker_bps) rate that was actually in effect at the fill’s block_timestamp (ASOF join against the builder fee-rate history), so historical rate changes are accounted for correctly.
V2-only. Builder attribution is a Polymarket V2 concept - V1 fills are excluded from all metrics.

Time range

By default the endpoint uses a rolling window: 24h, 7d, 30d, or all (default). To score fees over an exact interval instead, pass start_time and/or end_time as Unix seconds — when either is set it overrides window. The response echoes the effective start_time, end_time, and builder_code that were applied to the query.

Authorizations

x-api-key
string
header
required

Path Parameters

wallet
string
required

Wallet address (0x + 40 hex)

Query Parameters

window
string
default:all

Rolling window: 24h, 7d, 30d, or all. Ignored if start_time/end_time provided.

start_time
integer | null

Unix seconds, inclusive. Overrides window if set.

end_time
integer | null

Unix seconds, exclusive. Overrides window if set.

builder_code
string | null

Restrict to a single builder (bytes32 hex).

limit
integer
default:50

Max per-builder breakdown rows

Required range: 1 <= x <= 500

Response

Successful Response

Builder fees a wallet has paid, with optional per-builder breakdown.

wallet_address
string
required

Wallet address (lowercased)

window
string
required

Time window: 24h, 7d, 30d, all, or 'custom' when start_time/end_time supplied

total_builder_fee_usd
number
required

Total builder fees this wallet paid across all (filtered) builders

total_volume_usd
number
required

Wallet's total attributed V2 trade notional

total_trade_count
integer
required

Total attributed fill legs

builder_count
integer
required

Distinct builders this wallet traded via (within filter)

start_time
integer | null

Echo of start_time query param (Unix seconds), if provided

end_time
integer | null

Echo of end_time query param (Unix seconds), if provided

builder_code
string | null

Echo of builder_code filter, if provided

breakdown
WalletBuilderFeeBreakdownEntry · object[]

Per-builder breakdown, ranked by builder_fee_usd desc