Builder Analytics

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.

get/api/public/v1/builders/{builder}/profile

Path parameters

builderstring required

Builder address (0x-hex)

Builder address (0x-hex)

Query parameters

period'day' | 'week' | 'month'
topCoinsinteger

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

builderstring required
builderNamestring

Known display name for the builder; omitted if unknown

dataNotesstring required
feeTenthsBpinteger required

Most common requested fee over the last 7d of orders; 0 if no recent orders

feeTokensinteger required

Distinct fee tokens the builder has accrued revenue in

firstSeenstring required

First fee accrual in HL's ledger (RFC3339)

lastSeenstring required

Latest fee accrual in HL's ledger (RFC3339)

periodstring required
profitableUsersinteger required

Of those, wallets that are all-time profitable per the traders rollup

revenueUsdnumber double required

Exact ledger revenue over the period

totalUsersinteger required

Distinct wallets with attributed fills in the period

Example response

{
  "$schema": "https://api.coinversa.ai/schemas/BuilderProfileBody.json"
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.