Get Wallet Builder Fees

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

PK-probes order_filled_by_maker (sorted by maker). Each fill is scored at the (taker_bps, maker_bps) that was actually in effect at block_timestamp — ASOF join against builder_fee_rates FINAL, with a synthesized epoch-anchored row per builder so fills that predate the refresh worker's first observation also get scored.

Time range: pass window (24h/7d/30d/all) for convenience, or start_time + end_time (Unix seconds) for arbitrary ranges. If either timestamp is set, window is ignored.

Optional builder_code filters to a single builder.

On V2, OrderFilled.taker is the exchange contract — user identity is always maker, and is_taker=1 flags which leg is the taker side.

walletstring required

Wallet address (0x + 40 hex)

windowstring

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

start_timeinteger nullable

Unix seconds, inclusive. Overrides window if set.

end_timeinteger nullable

Unix seconds, exclusive. Overrides window if set.

builder_codestring nullable

Restrict to a single builder (bytes32 hex).

limitinteger

Max per-builder breakdown rows

Response

Successful Response

wallet_addressstring required

Wallet address (lowercased)

windowstring required

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

start_timeinteger nullable

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

end_timeinteger nullable

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

builder_codestring nullable

Echo of builder_code filter, if provided

total_builder_fee_usdnumber required

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

total_volume_usdnumber required

Wallet's total attributed V2 trade notional

total_trade_countinteger required

Total attributed fill legs

builder_countinteger required

Distinct builders this wallet traded via (within filter)

v1

Get Wallet Builder Fees

Path parameters

Query parameters

Response