---
title: "Builder profile"
method: GET
path: "/api/public/v1/builders/{builder}/profile"
tags: ["Builder Analytics"]
---

# Builder profile

`GET /api/public/v1/builders/{builder}/profile`

Single-builder overview: exact ledger revenue over the period, first/last fee accrual, distinct fee tokens, most common requested fee rate, a daily attributed series (fees, volume, users, fills) with the biggest day highlighted, top coins by attributed volume, and how many of the period's attributed wallets are all-time profitable. coins is null (unknown, never an empty list) when the live coin-split pass exceeds its budget — everything else always serves; see the response's dataNotes. Returns 404 for addresses with no revenue in the fee ledger.

## Path parameters

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

## Query parameters

- `period` 'day' | 'week' | 'month'
- `topCoins` integer

## Response `200`

OK

- BuilderProfileBody
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `biggestDay` BuilderDay
    - `attributedFeesUsd` number, double, required
    - `date` string, required — UTC day (YYYY-MM-DD)
    - `fills` integer, required
    - `users` integer, required
    - `volumeUsd` number, double, required
  - `builder` string, required
  - `builderName` string — Known display name for the builder; omitted if unknown
  - `coins` BuilderCoin[], nullable, required — Top coins by attributed volume; null (not empty) when the live coin-split pass exceeded its budget — see dataNotes. An empty array is a real 'no attributed coins'
    - `attributedFeesUsd` number, double, required
    - `coin` string, required
    - `fills` integer, required
    - `marketType` 'perp' | 'spot' | 'hip4', required
    - `volumeUsd` number, double, required
  - `daily` BuilderDay[], nullable, required — Daily attributed series (join plane — see dataNotes)
    - `attributedFeesUsd` number, double, required
    - `date` string, required — UTC day (YYYY-MM-DD)
    - `fills` integer, required
    - `users` integer, required
    - `volumeUsd` number, double, required
  - `dataNotes` string, required
  - `feeTenthsBp` integer, required — Most common requested fee over the last 7d of orders; 0 if no recent orders
  - `feeTokens` integer, required — Distinct fee tokens the builder has accrued revenue in
  - `firstSeen` string, required — First fee accrual in HL's ledger (RFC3339)
  - `lastSeen` string, required — Latest fee accrual in HL's ledger (RFC3339)
  - `period` string, required
  - `profitableUsers` integer, required — Of those, wallets that are all-time profitable per the traders rollup
  - `revenueUsd` number, double, required — Exact ledger revenue over the period
  - `totalUsers` integer, required — Distinct wallets with attributed fills in the period
  - `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)

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `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)