Skip to main content
GET
/
v2
/
polymarket
/
builders
/
wallet
/
{wallet}
Get Wallet Builder Fees
curl --request GET \
  --url https://api.predexon.com/v2/polymarket/builders/wallet/{wallet} \
  --header 'x-api-key: <api-key>'
{
  "wallet_address": "<string>",
  "window": "<string>",
  "total_builder_fee_usd": 123,
  "total_volume_usd": 123,
  "total_trade_count": 123,
  "builder_count": 123,
  "breakdown": [
    {
      "builder_code": "<string>",
      "builder_fee_usd": 123,
      "volume_usd": 123,
      "trade_count": 123,
      "taker_fill_count": 123,
      "maker_fill_count": 123,
      "current_taker_bps": 123,
      "current_maker_bps": 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.

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.

Windows

24h, 7d (default), 30d, or all.
ConstraintValue
limitCaps the number of per-builder breakdown rows returned.

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

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, or all

total_builder_fee_usd
number
required

Total builder fees this wallet paid across all 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

breakdown
WalletBuilderFeeBreakdownEntry · object[]

Per-builder breakdown, ranked by builder_fee_usd desc