> ## Documentation Index
> Fetch the complete documentation index at: https://docs.polynode.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Builder Fees

> Rank builders by attributed fee generation and inspect their fee-bearing fills.

Builder fee data is based on the `builder` field on attributed fills. `total_fees` is protocol fee generated by attributed fills, not the builder's off-chain rev-share payout.

Canonical endpoint references:

* [Builder Leaderboard](/data/builders/list)
* [Builder Detail](/data/builders/detail)
* [Builder Trades](/data/builders/trades)

## Rank Builders by Fees

```bash theme={null}
curl "https://api.polynode.dev/v3/builders?sort=fees&limit=1" \
  -H "x-api-key: $POLYNODE_API_KEY"
```

## Inspect Builder Trades

```bash theme={null}
curl "https://api.polynode.dev/v3/builders/0x4898df15ec6590495dc6c0fedf951ade3e64001d47f9caf44a64e86fc11959df/trades?limit=1" \
  -H "x-api-key: $POLYNODE_API_KEY"
```

## Builder Trade Filters

| Parameter         | Purpose                     |
| ----------------- | --------------------------- |
| `token_id`        | One outcome token           |
| `condition_id`    | All outcomes in a condition |
| `market_slug`     | Market URL slug             |
| `event_slug`      | All markets in an event     |
| `side`            | `buy` or `sell`             |
| `min_amount`      | Minimum raw maker amount    |
| `category`        | Market category             |
| `tag_slug`        | Market tag slug             |
| `after`, `before` | Time range                  |

<Note>
  Builder codes are 32-byte hex tags, not wallet addresses.
</Note>