Retention endpoints read each user's whole history, so the web app calls them without a date window. They share the Analytics filters and the same 429 retry behaviour.
Retrieve time to launch
/admin/dashboard/time-to-launch Returns how many users reached each launch-count milestone, by days since signup.
- Token
- Upgraded session token of an account with admin rights.
- Read-only tokens
- Allowed.
- Retry
- Safe to retry
Query parameters
-
chain_idenum OptionalRestricts to one chain.allis not sent.Possible valuessolethbscbaserobinhoodmonadarcxlayer -
currencyenum OptionalUnit of the money amounts. The web app offersnativeonly with achain_id.Possible valuesusdnative -
include_archivedboolean OptionalCounts archived launches. -
count_group_membersboolean OptionalCounts launches that belong to a launch group. -
utc_offsetinteger OptionalOffset from UTC, in hours, for bucket boundaries. The web app leaves it out for UTC+1. -
milestonesstring OptionalComma-separated launch counts, such as1,5,10. -
max_daysinteger OptionalDays after signup to cover.
Returns 200 OK · application/json
-
max_daysintegerDays covered. -
total_usersintegerUsers counted. -
active_usersintegerUsers with at least one launch. -
milestonesarray<object>One entry per milestone.Child attributes 3
-
milestoneintegerLaunch count. -
reachedintegerUsers who ever reached it. -
cumulativearray<integer>Index is days after signup; value is users who had reached it by then.
-
Errors
| Status | Code | When and what to do |
|---|---|---|
| 400 | bad_request | milestones is not a comma-separated list of launch counts. More than 20 milestones answers at most 20 milestones. Send up to 20 comma-separated launch counts, such as 1,5,10. |
| 429 | too_many_requests | All analytics slots stayed busy for 45 seconds: the API runs at most three analytics computations at once. The web app retries with exponential backoff (2 s doubling, capped at 30 s, up to 8 retries). Retry with exponential backoff. |
| 429 | too_many_requests | The aggregate ran past the 60-second analytics limit and was stopped. The API serves its last answer for the same query instead when it has one from the past hour, so this means it has none. Retry with exponential backoff, and narrow the query, for example to one chain_id, if it keeps failing. |
Also the common errors: 401 for a missing or expired session, 403 forbidden without the admin role and 429 when rate limited.
Web client proxima.admin.getDashboardTimeToLaunch(params) src/lib/proxima/endpoints/admin.ts
Retrieve churn
/admin/dashboard/churn Returns users grouped by days since their last launch.
- Token
- Upgraded session token of an account with admin rights.
- Read-only tokens
- Allowed.
- Retry
- Safe to retry
Query parameters
-
chain_idenum OptionalRestricts to one chain.allis not sent.Possible valuessolethbscbaserobinhoodmonadarcxlayer -
currencyenum OptionalUnit of the money amounts. The web app offersnativeonly with achain_id.Possible valuesusdnative -
include_archivedboolean OptionalCounts archived launches. -
count_group_membersboolean OptionalCounts launches that belong to a launch group. -
utc_offsetinteger OptionalOffset from UTC, in hours, for bucket boundaries. The web app leaves it out for UTC+1.
Returns 200 OK · application/json
-
bucketsarray<object>Inactivity buckets.Child attributes 4
-
labelstringBucket label. -
min_daysintegerLower bound, in days. -
max_daysinteger | nullUpper bound, in days.nullfor the last bucket. -
user_countintegerUsers in the bucket.
-
-
currencyenumUnit applied to the money amounts.Possible valuesusdnative
Errors
| Status | Code | When and what to do |
|---|---|---|
| 400 | bad_request | currency is not usd or native. Send currency=usd or currency=native. |
| 429 | too_many_requests | All analytics slots stayed busy for 45 seconds: the API runs at most three analytics computations at once. The web app retries with exponential backoff (2 s doubling, capped at 30 s, up to 8 retries). Retry with exponential backoff. |
| 429 | too_many_requests | The aggregate ran past the 60-second analytics limit and was stopped. The API serves its last answer for the same query instead when it has one from the past hour, so this means it has none. Retry with exponential backoff, and narrow the query, for example to one chain_id, if it keeps failing. |
Also the common errors: 401 for a missing or expired session, 403 forbidden without the admin role and 429 when rate limited.
Web client proxima.admin.getDashboardChurn(params) src/lib/proxima/endpoints/admin.ts
List churned users
/admin/dashboard/churn/users Returns the users in an inactivity range, with their last launch.
- Token
- Upgraded session token of an account with admin rights.
- Read-only tokens
- Allowed.
- Retry
- Safe to retry
Query parameters
-
chain_idenum OptionalRestricts to one chain.allis not sent.Possible valuessolethbscbaserobinhoodmonadarcxlayer -
currencyenum OptionalUnit of the money amounts. The web app offersnativeonly with achain_id.Possible valuesusdnative -
include_archivedboolean OptionalCounts archived launches. -
count_group_membersboolean OptionalCounts launches that belong to a launch group. -
utc_offsetinteger OptionalOffset from UTC, in hours, for bucket boundaries. The web app leaves it out for UTC+1. -
min_daysinteger RequiredMinimum days since the last launch. -
max_daysinteger OptionalMaximum days since the last launch. -
limitinteger OptionalPage size. -
offsetinteger OptionalNumber of rows to skip. -
sortenum OptionalSort key.Possible valuesusernameinactivelaunchesrevenuepnl -
orderenum OptionalSort direction.descis biggest first.Possible valuesascdesc
Returns 200 OK · application/json
-
usersarray<object>Users.Child attributes 7
-
license_keystringLicense key. -
usernamestringUsername. -
days_since_last_launchintegerDays since the last launch. -
total_launchesintegerLifetime launches. -
total_revenue_grossstringLifetime fees paid, in the requestedcurrency(micro-USD, or lamports or wei), as an integer string. -
total_pnlstringLifetime launch P&L, in the requestedcurrency(micro-USD, or lamports or wei), as an integer string. -
last_launchobjectLast launch:name,symbol,image_url,launched_at(Unix seconds),revenue_gross,pnl.
-
-
totalintegerTotal matching users. -
limitintegerApplied page size. -
offsetintegerApplied offset. -
currencyenumUnit applied to the money amounts.Possible valuesusdnative
Errors
| Status | Code | When and what to do |
|---|---|---|
| 400 | bad_request | currency is not usd or native. Send currency=usd or currency=native. |
| 429 | too_many_requests | All analytics slots stayed busy for 45 seconds: the API runs at most three analytics computations at once. The web app retries with exponential backoff (2 s doubling, capped at 30 s, up to 8 retries). Retry with exponential backoff. |
| 429 | too_many_requests | The aggregate ran past the 60-second analytics limit and was stopped. The API serves its last answer for the same query instead when it has one from the past hour, so this means it has none. Retry with exponential backoff, and narrow the query, for example to one chain_id, if it keeps failing. |
Also the common errors: 401 for a missing or expired session, 403 forbidden without the admin role and 429 when rate limited.
Web client proxima.admin.getDashboardChurnUsers(params) src/lib/proxima/endpoints/admin.ts
Retrieve signup cohorts
/admin/dashboard/cohorts Returns retention per monthly signup cohort.
- Token
- Upgraded session token of an account with admin rights.
- Read-only tokens
- Allowed.
- Retry
- Safe to retry
Query parameters
-
chain_idenum OptionalRestricts to one chain.allis not sent.Possible valuessolethbscbaserobinhoodmonadarcxlayer -
currencyenum OptionalUnit of the money amounts. The web app offersnativeonly with achain_id.Possible valuesusdnative -
include_archivedboolean OptionalCounts archived launches. -
count_group_membersboolean OptionalCounts launches that belong to a launch group. -
utc_offsetinteger OptionalOffset from UTC, in hours, for bucket boundaries. The web app leaves it out for UTC+1. -
hide_inactiveboolean OptionalLeaves out users who never launched.
Returns 200 OK · application/json
-
windowsarray<object>Retention windows:label,start_days,end_days(days after signup). -
cohortsarray<object>One entry per signup month.Child attributes 4
-
cohortstringSignup month,YYYY-MM(UTC). -
start_atintegerMonth start, Unix seconds. -
user_countintegerUsers in the cohort. -
retentionarray<object>Per window, in the order ofwindows:eligible,active.
-
Errors
| Status | Code | When and what to do |
|---|---|---|
| 429 | too_many_requests | All analytics slots stayed busy for 45 seconds: the API runs at most three analytics computations at once. The web app retries with exponential backoff (2 s doubling, capped at 30 s, up to 8 retries). Retry with exponential backoff. |
| 429 | too_many_requests | The aggregate ran past the 60-second analytics limit and was stopped. The API serves its last answer for the same query instead when it has one from the past hour, so this means it has none. Retry with exponential backoff, and narrow the query, for example to one chain_id, if it keeps failing. |
Also the common errors: 401 for a missing or expired session, 403 forbidden without the admin role and 429 when rate limited.
Web client proxima.admin.getDashboardCohorts(params) src/lib/proxima/endpoints/admin.ts
List a cohort's users
/admin/dashboard/cohorts/users Returns the users of one signup cohort with their launches per window.
- Token
- Upgraded session token of an account with admin rights.
- Read-only tokens
- Allowed.
- Retry
- Safe to retry
Query parameters
-
chain_idenum OptionalRestricts to one chain.allis not sent.Possible valuessolethbscbaserobinhoodmonadarcxlayer -
currencyenum OptionalUnit of the money amounts. The web app offersnativeonly with achain_id.Possible valuesusdnative -
include_archivedboolean OptionalCounts archived launches. -
count_group_membersboolean OptionalCounts launches that belong to a launch group. -
utc_offsetinteger OptionalOffset from UTC, in hours, for bucket boundaries. The web app leaves it out for UTC+1. -
hide_inactiveboolean OptionalLeaves out users who never launched. -
cohortstring RequiredSignup month,YYYY-MM. -
limitinteger OptionalPage size. The web app asks for 2000. -
offsetinteger OptionalNumber of rows to skip.
Returns 200 OK · application/json
-
windowsarray<object>Retention windows:label,start_days,end_days(days after signup). -
usersarray<object>Users.Child attributes 6
-
license_keystringLicense key. -
usernamestringUsername. -
created_atintegerSignup time, Unix seconds. -
total_launchesintegerLifetime launches. -
last_launch_atinteger | nullLast launch time, Unix seconds. -
launchesarray<integer>Launches per window, in the order ofwindows.
-
-
totalintegerTotal users in the cohort. -
limitintegerApplied page size. -
offsetintegerApplied offset.
Errors
| Status | Code | When and what to do |
|---|---|---|
| 400 | bad_request | cohort is not a month in YYYY-MM form. Send cohort as YYYY-MM, such as 2026-09. |
| 429 | too_many_requests | All analytics slots stayed busy for 45 seconds: the API runs at most three analytics computations at once. The web app retries with exponential backoff (2 s doubling, capped at 30 s, up to 8 retries). Retry with exponential backoff. |
| 429 | too_many_requests | The aggregate ran past the 60-second analytics limit and was stopped. The API serves its last answer for the same query instead when it has one from the past hour, so this means it has none. Retry with exponential backoff, and narrow the query, for example to one chain_id, if it keeps failing. |
Also the common errors: 401 for a missing or expired session, 403 forbidden without the admin role and 429 when rate limited.
Web client proxima.admin.getDashboardCohortUsers(params) src/lib/proxima/endpoints/admin.ts
Retrieve stickiness
/admin/dashboard/stickiness Returns active users per short period against active users per longer period.
- Token
- Upgraded session token of an account with admin rights.
- Read-only tokens
- Allowed.
- Retry
- Safe to retry
For example numerator=day and denominator=month gives daily over monthly active users.
Query parameters
-
chain_idenum OptionalRestricts to one chain.allis not sent.Possible valuessolethbscbaserobinhoodmonadarcxlayer -
currencyenum OptionalUnit of the money amounts. The web app offersnativeonly with achain_id.Possible valuesusdnative -
include_archivedboolean OptionalCounts archived launches. -
count_group_membersboolean OptionalCounts launches that belong to a launch group. -
utc_offsetinteger OptionalOffset from UTC, in hours, for bucket boundaries. The web app leaves it out for UTC+1. -
numeratorenum OptionalShort period.Possible valuesdayweekmonthyearall -
denominatorenum OptionalLong period.Possible valuesdayweekmonthyearall
Returns 200 OK · application/json
-
numeratorenumShort period applied.Possible valuesdayweekmonthyearall -
denominatorenumLong period applied.Possible valuesdayweekmonthyearall -
pointsarray<object>One point per short period.Child attributes 4
-
period_startintegerShort period start, Unix seconds. -
active_usersintegerUsers with a launch in the short period. -
denominator_period_startintegerEnclosing long period start, Unix seconds. -
denominator_active_usersintegerUsers with a launch in the long period.
-
Errors
| Status | Code | When and what to do |
|---|---|---|
| 400 | bad_request | numerator or denominator is not a known period. Send day, week, month, year or all. |
| 429 | too_many_requests | All analytics slots stayed busy for 45 seconds: the API runs at most three analytics computations at once. The web app retries with exponential backoff (2 s doubling, capped at 30 s, up to 8 retries). Retry with exponential backoff. |
| 429 | too_many_requests | The aggregate ran past the 60-second analytics limit and was stopped. The API serves its last answer for the same query instead when it has one from the past hour, so this means it has none. Retry with exponential backoff, and narrow the query, for example to one chain_id, if it keeps failing. |
Also the common errors: 401 for a missing or expired session, 403 forbidden without the admin role and 429 when rate limited.
Web client proxima.admin.getDashboardStickiness(params) src/lib/proxima/endpoints/admin.ts