Fees, rebates, rewards, and builder payouts are separate concepts. Trader-paid fees come from executed fills. Fee events show receiver-level on-chain fee charges. Maker rebates and reward configuration are Polymarket accounting surfaces. Builder rev share is paid off-chain and is not the same as
total_fees.Fee Surfaces
| Need | Endpoint | Use this when |
|---|---|---|
| Wallet fee-bearing fills | GET /v3/wallets/{address}/fees-paid | You want trades where a wallet paid a nonzero fill fee |
| Global fee events | GET /v3/fees | You want fee charged events across the platform |
| Fees by receiver | GET /v3/fees/{receiver} | You want fee events received by one address |
| Builder fee ranking | GET /v3/builders?sort=fees | You want builders ranked by fees generated on attributed fills |
| Builder fee trades | GET /v3/builders/{code}/trades | You want the underlying attributed fills, including per-fill fee |
| Maker rebates | GET /v3/wallets/{address}/rebates | You want Polymarket-reported maker rebates for one maker/date |
| Reward configs | GET /v3/rewards/markets | You want public reward-market configuration, not wallet-earned rewards |