Wallet Builder Fees
Total builder fees a wallet has paid, with a per-builder breakdown
(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.
Time range
By default the endpoint uses a rollingwindow: 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.
| Parameter | Description |
|---|---|
window | Rolling window: 24h, 7d, 30d, or all (default). Ignored if start_time/end_time are provided. |
start_time | Unix seconds, inclusive. Overrides window. |
end_time | Unix seconds, exclusive. Overrides window. |
builder_code | Restrict the result to a single builder (bytes32 hex). |
limit | Caps the number of per-builder breakdown rows returned. |
start_time, end_time, and builder_code that were applied to the query.Authorizations
Path Parameters
Wallet address (0x + 40 hex)
Query Parameters
Rolling window: 24h, 7d, 30d, or all. Ignored if start_time/end_time provided.
Unix seconds, inclusive. Overrides window if set.
Unix seconds, exclusive. Overrides window if set.
Restrict to a single builder (bytes32 hex).
Max per-builder breakdown rows
1 <= x <= 500Response
Successful Response
Builder fees a wallet has paid, with optional per-builder breakdown.
Wallet address (lowercased)
Time window: 24h, 7d, 30d, all, or 'custom' when start_time/end_time supplied
Total builder fees this wallet paid across all (filtered) builders
Wallet's total attributed V2 trade notional
Total attributed fill legs
Distinct builders this wallet traded via (within filter)
Echo of start_time query param (Unix seconds), if provided
Echo of end_time query param (Unix seconds), if provided
Echo of builder_code filter, if provided
Per-builder breakdown, ranked by builder_fee_usd desc
