Sign in
Builder Analytics

Builder retention cohorts

Retention matrix for the builder's users, computed on the orders plane: wallets are cohorted by the calendar month (or ISO week, with granularity=weekly) of their first builder-fee order via this builder, and 'active in month M' means they placed at least one builder-fee order that month (the order need not fill, so 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; covers the last 12 months or 16 weeks depending on granularity.

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

Path parameters

builderstring required

Builder address (0x-hex)

Builder address (0x-hex)

Query parameters

granularity'monthly' | 'weekly'
revenueWeightedboolean

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

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

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