COcoinversa
Builder Analytics

Builder user lifecycle

Changed on

Every wallet that ever traded via this builder, partitioned into mutually exclusive stages by recent activity: active (attributed fill within 7d), cooling (30d), switched (no fill via this builder in 30d but at least one via a DIFFERENT builder — detectable only with all-builder attribution), dormant (90d), and movedOn. Headline ratios: trueRetention, churn, and competitiveLoss (switched share) with competitiveLossFeesUsd — builder fees those switched wallets paid to other builders in the last 30d (null, meaning unknown and never zero, when the fee probe exceeds its budget — the buckets and ratios always serve; see the response's dataNotes).

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

Request

Path parameters

builderstring required

Builder address (0x-hex)

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

churnnumber 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)

competitiveLossnumber 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

competitiveLossFeesUsdnumber double nullable 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

dataNotesstring required
totalUsersinteger 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)

trueRetentionnumber 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

Example response

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

Changes

  • f2eba29805e5Revision changes
    • info

      added the non-success response with the status

    • info

      removed the non-success response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status