---
title: "Builders a wallet trades through"
method: GET
path: "/api/public/v1/trader/{address}/builders"
tags: ["Builder Analytics"]
---

# Builders a wallet trades through

`GET /api/public/v1/trader/{address}/builders`

Every builder the wallet had attributed fills via within the lookback window (clamped to 90d), ordered by builder fees paid. Each row carries the wallet's fills, fees, and volume via that builder plus first/last attributed-fill timestamps within the window.

## Path parameters

- `address` string, required — Wallet address (0x-hex)

## Query parameters

- `since` string — Lookback window like 30m, 6h, 30d (clamped to 90d)

## Response `200`

OK

- TraderBuildersBody
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `address` string, required
  - `builders` TraderBuilderRow[], nullable, required — Ordered by fees paid, descending
    - `builder` string, required
    - `builderFeesUsd` number, double, required — Builder fees the wallet paid via this builder in the window
    - `builderName` string — Known display name for the builder; omitted if unknown
    - `fills` integer, required
    - `firstSeen` string, required — First attributed fill via this builder within the window (RFC3339)
    - `lastSeen` string, required — Latest attributed fill via this builder within the window (RFC3339)
    - `volumeUsd` number, double, required
  - `dataNotes` string, required
  - `verified` BuilderStamp
    - `coverage` BuilderCoverage, required
      - `attributed_fees_usd` number, double, required — Join-attributed fees in the rollup window
      - `computed_at` string, required — When the rollup was computed (RFC3339)
      - `ledger_fees_usd` number, double, required — Exact ledger revenue in the rollup window
      - `ratio` number, double, required — attributed_fees / ledger_fees — the share of revenue the fill-level metrics account for
      - `window_end` string, required — End of that window (RFC3339)
      - `window_start` string, required — Start of the window the coverage rollup was computed over (RFC3339)
    - `ledger_block` integer, required — Latest block in HL's builder-fee ledger this data was verified against
    - `ledger_chain_time` string, required — Chain timestamp of that ledger entry (RFC3339)
  - `window` string, required — Echo of the requested since parameter; lookbacks beyond 90d still echo as requested while the data is clamped to 90d

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `422` — Unprocessable Entity
- `429` — Too Many Requests
- `500` — Internal Server Error
- `504` — Gateway Timeout

---

[API](https://skmtc.dev/coinversa/apis/coinversa-api.md) · [All operations](https://skmtc.dev/coinversa/apis/coinversa-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/coinversa/coinversa-api/revisions/77c03c427063/schema)