Skip to main content
GET
Builder user lifecycle

Authorizations

X-API-Key
string
header
required

Path Parameters

builder
string
required

Builder address (0x-hex)

Response

OK

active
object
required

Definition: last attributed fill via THIS builder within 7 days

builder
string
required
churn
number<double>
required

Definition: (dormant + movedOn) / totalUsers — the share that stopped filling via this builder AND shows no attributed fill via any other builder in the last 30 days (left the attributed builder ecosystem, not poached)

competitiveLoss
number<double>
required

Definition: switched / totalUsers — the share that stopped filling via this builder within the last 30 days while filling via a DIFFERENT builder in those same 30 days. Requires cross-builder fill attribution; interfaces without it necessarily report 0 here

competitiveLossFeesUsd
number<double> | null
required

Builder fees the switched wallets paid to OTHER builders over the last 30 days — revenue measurably lost to competitors; null when the fee probe exceeded its budget (see dataNotes) — null means unknown, never zero

cooling
object
required

Definition: last attributed fill via THIS builder within 30 days, but more than 7 days ago

dataNotes
string
required
dormant
object
required

Definition: no attributed fill via ANY builder within 30 days, and the last fill via this builder was within 90 days

movedOn
object
required

Definition: no attributed fill via any builder within 30 days, and no attributed fill via this builder within 90 days (wallets whose orders never filled at all land here too)

switched
object
required

Definition: NO attributed fill via this builder within 30 days BUT >= 1 attributed fill via a DIFFERENT builder within 30 days — wallets demonstrably still trading builder flow, just not here. The other-builder fill's order is recovered up to 90 days before the 30-day window; fills of orders resting longer are missed (see dataNotes)

totalUsers
integer<int32>
required

Every wallet that ever placed a builder-fee order via this builder, over its entire history (orders plane — includes wallets whose orders never filled; see dataNotes)

trueRetention
number<double>
required

Definition: (active + cooling) / totalUsers — the share of all historical order-placing users that still filled via this builder within the last 30 days

$schema
string<uri>
read-only

A URL to the JSON Schema for this object.

Example:

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

builderName
string

Known display name for the builder; omitted if unknown

verified
object