Skip to main content
GET
/
v2
/
polymarket
/
builders
/
{builder_code}
Get Builder Stats
curl --request GET \
  --url https://api.predexon.com/v2/polymarket/builders/{builder_code} \
  --header 'x-api-key: <api-key>'
{
  "builder_code": "<string>",
  "window": "<string>",
  "volume_usd": 123,
  "builder_fee_usd": 123,
  "platform_fee_usd": 123,
  "trade_count": 123,
  "unique_traders": 123,
  "unique_markets": 123,
  "current_taker_bps": 123,
  "current_maker_bps": 123,
  "first_seen_at": 123,
  "last_seen_at": 123,
  "fee_rate_history": [
    {
      "taker_bps": 123,
      "maker_bps": 123,
      "valid_from": 123,
      "valid_to": 123
    }
  ]
}
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.
FieldRange
taker_bps0–100
maker_bps0–50

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[]