Skip to main content
GET
Builder user journey economics

Authorizations

X-API-Key
string
header
required

Path Parameters

builder
string
required

Builder address (0x-hex)

Response

OK

avgRevenueUsd
number<double> | null
required

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

builder
string
required
concentration
number<double> | null
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)

dataNotes
string
required
daysToHalfRevenue
object
required

Days from first fill to the day cumulative attributed fees first reached 50% of the wallet's lifetime total

daysToPeak
object
required

Days from a wallet's first attributed fill to its single highest-revenue day (earliest such day on fee ties)

daysToThreeQuartersRevenue
object
required

Days from first fill to the day cumulative attributed fees first reached 75% of the wallet's lifetime total

medianRevenueUsd
number<double> | null
required

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

minFills
integer<int32>
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)

peakDayDistribution
object
required

Qualifying wallets bucketed by when their peak-revenue day landed

users
integer<int32>
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)

$schema
string<uri>
read-only

A URL to the JSON Schema for this object.

Example:

"https://api.coinversa.ai/schemas/BuilderJourneyBody.json"

builderName
string

Known display name for the builder; omitted if unknown

verified
object