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

Documentation Index

Fetch the complete documentation index at: https://docs.predexon.com/llms.txt

Use this file to discover all available pages before exploring further.

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 (null if rate not yet fetched)

current_maker_bps
integer | null

Current maker bps (null if rate not yet fetched)

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