Sign in
Builder Analytics

Builder user journey economics

Lifetime economics of the builder's trailing-year acquisition cohort (wallets with 3+ attributed fills): average and median revenue per wallet, concentration (avg/median), median days from first fill to peak-revenue day and to 50% and 75% of lifetime revenue, and where users peak (before day 7, days 7-30, after day 30). Answers how fast and how unevenly a builder monetizes new users. BREAKING (2026-08-28): avgRevenueUsd, medianRevenueUsd, concentration, and every avgDays/medianDays field are now NULLABLE and serve null when users = 0 (no qualifying cohort). They previously served 0, which clients could not distinguish from a cohort that genuinely earned nothing. Counts (users, peakDayDistribution) are unchanged and still serve 0.

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

Path parameters

builderstring required

Builder address (0x-hex)

Builder address (0x-hex)

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

avgRevenueUsdnumber double nullable required

Mean lifetime attributed builder fees per qualifying wallet; null when there is no qualifying cohort (users = 0). Null means unknown, never zero

builderstring required
builderNamestring

Known display name for the builder; omitted if unknown

concentrationnumber double nullable required

avgRevenueUsd / medianRevenueUsd — how whale-skewed per-user revenue is (1 = evenly spread). Null when there is no qualifying cohort, and also when the median is 0 (the ratio is undefined)

dataNotesstring required
medianRevenueUsdnumber double nullable required

Median lifetime attributed builder fees per qualifying wallet; null when there is no qualifying cohort (users = 0). Null means unknown, never zero

minFillsinteger required

Inclusion floor: wallets need >= this many lifetime attributed fills (fixed at 3 so one-shot wallets don't define days-to-peak as trivially zero)

usersinteger required

Wallets the journey stats are computed over — those whose first builder-fee order via this builder was within the last 365 days and with at least minFills lifetime attributed fills (see dataNotes)

Example response

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

Changes

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