Builder Analytics

Builder retention cohorts

Changed on

Retention matrix for the builder's users: wallets are cohorted by the calendar month (or ISO week, with granularity=weekly) of their first activity via this builder, and each later period counts how many of that cohort were active again. WHICH PLANE defines 'first' and 'active' is disclosed per response in dataNotes: the attribution rollup's presence rows (at least one attributed fill that period) whenever it can serve the builder, otherwise the orders plane (at least one builder-fee order placed that period — the order need not fill, so those counts can exceed the attributed-fill user counts on the cohorts and overlap endpoints). Oldest cohort first; each cohort's activeWallets series starts at its own period (index 0 == newWallets). revenueWeighted=true adds a parallel activeRevenueUsd fee series, cohorted identically to activeWallets; covers the last 12 months or 16 weeks depending on granularity.

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

Request

Path parameters

builderstring required

Builder address (0x-hex)

Query parameters

granularity'monthly' | 'weekly'
revenueWeightedboolean

Add the attributed-fee series per cohort (fill plane)

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
granularitystring required

Cohort period length: 'monthly' (calendar months) or 'weekly' (ISO weeks)

revenueWeightedboolean required

Whether the per-cohort activeRevenueUsd fee series is included

Example response

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

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