Analytics
Aggregate revenue, P&L, launches and user activity for the admin dashboard.
Analytics endpoints back the admin dashboard, metrics, launch stats, wallets, tracker and sharing pages. Aggregates leave out internal accounts and draft launches.
Money amounts are integer strings in the requested currency: micro-USD by default, or lamports or wei for native. Timestamps are Unix seconds.
Each /admin/dashboard/* answer is a cached aggregate. A 429 means it is still being computed or no slot is free: retry with backoff.
- GET
/admin/dashboard - GET
/admin/dashboard/summary - GET
/admin/dashboard/series - GET
/admin/dashboard/users - GET
/admin/dashboard/users-over-time - GET
/admin/dashboard/heatmap - GET
/admin/dashboard/activity-distribution - GET
/admin/dashboard/top-users - GET
/admin/dashboard/launch-stats - GET
/admin/dashboard/tracker - GET
/admin/dashboard/wallets - GET
/admin/sharing/stats
The Dashboard user object
An account's totals over the requested window.
Attributes
-
license_keystringLicense key. -
usernamestringUsername. -
launch_countintegerLaunches in the window. -
revenue_grossstringFees paid, in the requestedcurrency(micro-USD, or lamports or wei), as an integer string. -
revenue_netstringFees after referral, in the requestedcurrency(micro-USD, or lamports or wei), as an integer string. -
pnlstringLaunch P&L, in the requestedcurrency(micro-USD, or lamports or wei), as an integer string.
Retrieve the event dashboard
/admin/dashboard Returns platform event totals, grouped by the dimensions you choose.
- Token
- Upgraded session token of an account with admin rights.
- Read-only tokens
- Allowed.
- Retry
- Safe to retry
Backs the admin metrics page. Events include trade.buy, trade.sell, funding, cex_funding, withdraw, creator_fee, cashback, referral_payout, gross_revenue, fee_sweep, launch.create and launch.deploy.
Query parameters
-
sinceinteger OptionalWindow start, Unix seconds. -
untilinteger OptionalWindow end, Unix seconds. -
chainstring OptionalRestricts to one chain. -
event_typestring OptionalRestricts to one event type, such astrade.buy. -
sourcestring OptionalRestricts to one event source. -
group_bystring OptionalComma-separated dimensions:day,chain,event_type,source,platform,quote_mint.
Returns 200 OK · application/json
-
fromintegerWindow start applied, Unix seconds. -
tointegerWindow end applied, Unix seconds. -
group_byarray<string>Dimensions applied. -
rowsarray<object>One row per group. Only the grouped dimensions are present.Child attributes 14
-
daystringDay, when grouped byday. -
chain_idstringChain, when grouped bychain. -
event_typestringEvent type, when grouped byevent_type. -
sourcestring | nullSource, when grouped bysource. -
platformstring | nullLaunchpad, when grouped byplatform. -
quote_mintstring | nullQuote token, when grouped byquote_mint. -
amount_nativestringNative amount, in lamports or wei, as an integer string. -
amount_quotestringQuote token amount, as an integer string. -
amount_usdstringUSD amount, in micro-USD, as an integer string. -
amount_tokenstringToken amount, as an integer string. -
fee_nativestringFees, in lamports or wei, as an integer string. -
fee_usdstringFees, in micro-USD, as an integer string. -
event_countintegerNumber of events. -
count_sumintegerSum of the events' counts.
-
Errors
| Status | Code | When and what to do |
|---|---|---|
| 400 | bad_request | A group_by dimension is unknown. Group by day, chain, event_type, source, platform or quote_mint. |
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.getDashboard(params) src/lib/proxima/endpoints/admin.ts
Retrieve the dashboard summary
/admin/dashboard/summary Returns headline revenue, P&L, volume, launch and user totals.
- Token
- Upgraded session token of an account with admin rights.
- Read-only tokens
- Allowed.
- Retry
- Safe to retry
Query parameters
-
start_atinteger OptionalWindow start, Unix seconds, inclusive. Filters on launch time. -
end_atinteger OptionalWindow end, Unix seconds, inclusive. -
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.
Returns 200 OK · application/json
-
revenue_grossstringFees paid to Proxima, in the requestedcurrency(micro-USD, or lamports or wei), as an integer string. -
revenue_netstringFees after referral, in the requestedcurrency(micro-USD, or lamports or wei), as an integer string. -
referral_paidstringReferral paid, in the requestedcurrency(micro-USD, or lamports or wei), as an integer string. -
users_pnlstringUsers' combined launch P&L, in the requestedcurrency(micro-USD, or lamports or wei), as an integer string. -
total_profitstringSum of positive P&L, in the requestedcurrency(micro-USD, or lamports or wei), as an integer string. -
total_lossstringSum of negative P&L, in the requestedcurrency(micro-USD, or lamports or wei), as an integer string. -
total_soldstringVolume sold, in the requestedcurrency(micro-USD, or lamports or wei), as an integer string. -
total_boughtstringVolume bought, in the requestedcurrency(micro-USD, or lamports or wei), as an integer string. -
total_launchesintegerLaunches in the window. -
active_usersintegerUsers with a launch in the window. -
total_usersintegerAll users. -
currencyenumUnit applied to the money amounts.Possible valuesusdnative -
native_mixedbooleantruewhen native amounts span several chains. -
unitsobjectUnit labels for the amounts in the response.Child attributes 3
-
usdstringUnit of the USD amounts. -
nativestringUnit of the native amounts. -
timestringUnit of the timestamps.
-
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.getDashboardSummary(params) src/lib/proxima/endpoints/admin.ts
Retrieve the dashboard series
/admin/dashboard/series Returns launches, users, P&L and revenue per time bucket, split by launchpad.
- Token
- Upgraded session token of an account with admin rights.
- Read-only tokens
- Allowed.
- Retry
- Safe to retry
Query parameters
-
start_atinteger OptionalWindow start, Unix seconds, inclusive. Filters on launch time. -
end_atinteger OptionalWindow end, Unix seconds, inclusive. -
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. -
granularityenum OptionalBucket size. The API refuseshour.Possible valueshourdayweekmonth -
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>One entry per bucket.Child attributes 5
-
bucket_startintegerBucket start, Unix seconds. -
by_platformobjectStats per launchpad id:launch_count,active_users,pnl,revenue_gross,revenue_net. -
totalsobjectSame stats across launchpads. -
new_usersintegerAccounts created in the bucket. -
total_usersintegerAccounts at the end of the bucket.
-
-
granularityenumBucket size applied.Possible valueshourdayweekmonth -
currencyenumUnit applied to the money amounts.Possible valuesusdnative -
native_mixedbooleantruewhen native amounts span several chains. -
unitsobjectUnit labels for the amounts in the response.Child attributes 3
-
usdstringUnit of the USD amounts. -
nativestringUnit of the native amounts. -
timestringUnit of the timestamps.
-
Errors
| Status | Code | When and what to do |
|---|---|---|
| 400 | bad_request | granularity is not day, week or month. The API refuses hour, which the dashboard sends from its By Hour view. Send granularity as day, week or month. |
| 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.getDashboardSeries(params) src/lib/proxima/endpoints/admin.ts
List dashboard users
/admin/dashboard/users Returns each account's launches, revenue and P&L over the window.
- Token
- Upgraded session token of an account with admin rights.
- Read-only tokens
- Allowed.
- Retry
- Safe to retry
Query parameters
-
start_atinteger OptionalWindow start, Unix seconds, inclusive. Filters on launch time. -
end_atinteger OptionalWindow end, Unix seconds, inclusive. -
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. -
limitinteger OptionalPage size. The API defaults to 500 and caps at 2000. -
offsetinteger OptionalNumber of rows to skip. -
include_inactiveboolean OptionalIncludes accounts with no launch in the window.
Returns 200 OK · application/json
-
usersarray<object>Accounts. See Dashboard user. -
limitintegerApplied page size. -
offsetintegerApplied offset. -
currencyenumUnit applied to the money amounts.Possible valuesusdnative -
native_mixedbooleantruewhen native amounts span several chains. -
unitsobjectUnit labels for the amounts in the response.Child attributes 3
-
usdstringUnit of the USD amounts. -
nativestringUnit of the native amounts. -
timestringUnit of the timestamps.
-
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.getDashboardUsers(params) src/lib/proxima/endpoints/admin.ts
Retrieve top users over time
/admin/dashboard/users-over-time Returns revenue and launches per bucket for the top accounts, with the rest grouped.
- Token
- Upgraded session token of an account with admin rights.
- Read-only tokens
- Allowed.
- Retry
- Safe to retry
The top accounts are ranked over the whole window, so the same accounts appear in every bucket. The rest are summed under others_key.
Query parameters
-
start_atinteger OptionalWindow start, Unix seconds, inclusive. Filters on launch time. -
end_atinteger OptionalWindow end, Unix seconds, inclusive. -
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. -
granularityenum OptionalBucket size. The API refuseshour.Possible valueshourdayweekmonth -
utc_offsetinteger OptionalOffset from UTC, in hours, for bucket boundaries. The web app leaves it out for UTC+1. -
rank_byenum OptionalRanking.Possible valuesrevenuelaunches -
top_ninteger OptionalNumber of top accounts, 1 to 100.
Returns 200 OK · application/json
-
top_usersarray<object>Top accounts:license_key,username. -
others_keystringSeries key of the grouped remainder. Never a license key. -
bucketsarray<object>One entry per bucket.Child attributes 2
-
bucket_startintegerBucket start, Unix seconds. -
seriesobjectPer license key (andothers_key):revenue_gross,revenue_net,launches.
-
-
granularityenumBucket size applied.Possible valueshourdayweekmonth -
currencyenumUnit applied to the money amounts.Possible valuesusdnative -
unitsobjectUnit labels for the amounts in the response.Child attributes 3
-
usdstringUnit of the USD amounts. -
nativestringUnit of the native amounts. -
timestringUnit of the timestamps.
-
Errors
| Status | Code | When and what to do |
|---|---|---|
| 400 | bad_request | granularity is not day, week or month. The API refuses hour, which the dashboard sends from its By Hour view. Send granularity as day, week or month. |
| 400 | bad_request | rank_by is not revenue or launches. Send rank_by=revenue or rank_by=launches. |
| 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.getDashboardUsersOverTime(params) src/lib/proxima/endpoints/admin.ts
Retrieve the activity heatmap
/admin/dashboard/heatmap Returns launches, revenue and P&L per weekday and hour.
- Token
- Upgraded session token of an account with admin rights.
- Read-only tokens
- Allowed.
- Retry
- Safe to retry
Query parameters
-
start_atinteger OptionalWindow start, Unix seconds, inclusive. Filters on launch time. -
end_atinteger OptionalWindow end, Unix seconds, inclusive. -
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
-
cellsarray<object>One cell per weekday and hour.Child attributes 5
-
weekdayintegerDay of the week, 0 (Monday) to 6 (Sunday). -
hourintegerHour, 0 to 23. -
launch_countintegerLaunches. -
revenue_grossstringFees paid, in the requestedcurrency(micro-USD, or lamports or wei), as an integer string. -
pnlstringLaunch P&L, in the requestedcurrency(micro-USD, or lamports or wei), as an integer string.
-
-
currencyenumUnit applied to the money amounts.Possible valuesusdnative -
native_mixedbooleantruewhen native amounts span several chains. -
unitsobjectUnit labels for the amounts in the response.Child attributes 3
-
usdstringUnit of the USD amounts. -
nativestringUnit of the native amounts. -
timestringUnit of the timestamps.
-
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.getDashboardHeatmap(params) src/lib/proxima/endpoints/admin.ts
Retrieve the activity distribution
/admin/dashboard/activity-distribution Returns how many users made each number of launches, with their revenue.
- Token
- Upgraded session token of an account with admin rights.
- Read-only tokens
- Allowed.
- Retry
- Safe to retry
Query parameters
-
start_atinteger OptionalWindow start, Unix seconds, inclusive. Filters on launch time. -
end_atinteger OptionalWindow end, Unix seconds, inclusive. -
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.
Returns 200 OK · application/json
-
rowsarray<object>One row per distinct launch count,0included.Child attributes 4
-
launch_countintegerLaunches per user. -
user_countintegerUsers with that many launches. -
revenue_grossstringFees paid, in the requestedcurrency(micro-USD, or lamports or wei), as an integer string. -
revenue_netstringFees after referral, in the requestedcurrency(micro-USD, or lamports or wei), as an integer string.
-
-
total_usersintegerUsers counted. -
currencyenumUnit applied to the money amounts.Possible valuesusdnative -
native_mixedbooleantruewhen native amounts span several chains.
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.getDashboardActivityDistribution(params) src/lib/proxima/endpoints/admin.ts
Retrieve top users
/admin/dashboard/top-users Returns the top accounts by a metric, with everyone else summed.
- Token
- Upgraded session token of an account with admin rights.
- Read-only tokens
- Allowed.
- Retry
- Safe to retry
Query parameters
-
start_atinteger OptionalWindow start, Unix seconds, inclusive. Filters on launch time. -
end_atinteger OptionalWindow end, Unix seconds, inclusive. -
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. -
rank_byenum OptionalRanking metric.Possible valueslaunchesrevenue_grossrevenue_netpnl -
top_ninteger OptionalNumber of top accounts.
Returns 200 OK · application/json
-
toparray<object>Top accounts. See Dashboard user. -
othersobjectEveryone else, summed.Child attributes 6
-
user_countintegerUsers. -
launch_countintegerLaunches. -
revenue_grossstringFees paid, in the requestedcurrency(micro-USD, or lamports or wei), as an integer string. -
revenue_netstringFees after referral, in the requestedcurrency(micro-USD, or lamports or wei), as an integer string. -
pnlstringLaunch P&L, in the requestedcurrency(micro-USD, or lamports or wei), as an integer string. -
pnl_absstringSum of absolute P&L, in the requestedcurrency(micro-USD, or lamports or wei), as an integer string.
-
-
currencyenumUnit applied to the money amounts.Possible valuesusdnative -
native_mixedbooleantruewhen native amounts span several chains.
Errors
| Status | Code | When and what to do |
|---|---|---|
| 400 | bad_request | rank_by is not a ranking metric. The API also accepts revenue. Send rank_by as launches, revenue_gross, revenue_net or pnl. |
| 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.getDashboardTopUsers(params) src/lib/proxima/endpoints/admin.ts
Retrieve launch stats
/admin/dashboard/launch-stats Returns launch counts and per-launch metrics per period, optionally split by chain or launchpad.
- Token
- Upgraded session token of an account with admin rights.
- Read-only tokens
- Allowed.
- Retry
- Safe to retry
Metrics are [sum, samples] pairs: divide for the per-launch average, keep the sum for the total.
Query parameters
-
start_atinteger OptionalWindow start, Unix seconds, inclusive. Filters on launch time. -
end_atinteger OptionalWindow end, Unix seconds, inclusive. -
chain_idenum OptionalRestricts to one chain.allis not sent.Possible valuessolethbscbaserobinhoodmonadarcxlayer -
include_archivedboolean OptionalCounts archived launches. -
count_group_membersboolean OptionalCounts launches that belong to a launch group. -
granularityenum OptionalBucket size. The API refuseshour.Possible valueshourdayweekmonth -
utc_offsetinteger OptionalOffset from UTC, in hours, for bucket boundaries. The web app leaves it out for UTC+1. -
split_byenum OptionalSplit dimension.Possible valuesnonechainlaunchpad -
platformstring OptionalRestricts to one launchpad.
Returns 200 OK · application/json
-
granularityenumBucket size applied.Possible valueshourdayweekmonth -
split_byenumSplit applied.Possible valuesnonechainlaunchpad -
keysarray<string>Split keys, most launches first.allwhen unsplit. -
periodsarray<object>One entry per period:period(Unix seconds) andcellskeyed by split key, ornullwhen empty. -
totalsobjectCells over the whole window, keyed by split key.Child attributes 4
-
{split_key}objectTotals for one split key fromkeys.Child attributes 3
-
launchesintegerLaunches. -
countsobjectCounts by tag, such asmethod:mev,origin:imported,schedule:scheduled,mev_type:atomic,funding_type:cex. -
metricsobjectKeyed by launch method (allincluded), then metric name, to a[sum, samples]pair.
-
-
Errors
| Status | Code | When and what to do |
|---|---|---|
| 400 | bad_request | granularity is not day, week or month. The API refuses hour. Send granularity as day, week or month. |
| 400 | bad_request | split_by is not none, chain or launchpad. Send split_by as none, chain or launchpad. |
| 400 | bad_request | The window spans 1500 buckets or more at this granularity. Shorten the window or use a coarser granularity. |
| 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. |
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.getLaunchStats(params) src/lib/proxima/endpoints/admin.ts
Retrieve wallet tracker stats
/admin/dashboard/tracker Returns wallet tracker adoption, for all users and for active users.
- Token
- Upgraded session token of an account with admin rights.
- Read-only tokens
- Allowed.
- Retry
- Safe to retry
all counts every non-internal user; active only those who launched at least once.
Parameters
No parameters.
Returns 200 OK · application/json
-
allobjectEvery non-internal user.Child attributes 10
-
usersintegerUsers in the population. -
users_trackingintegerUsers tracking at least one wallet. -
users_tracking_svmintegerUsers tracking a Solana wallet. -
users_tracking_evmintegerUsers tracking an EVM wallet. -
tracked_walletsintegerTracked wallets. -
tracked_svmintegerTracked Solana wallets. -
tracked_evmintegerTracked EVM wallets. -
bookmarkedintegerBookmarked wallets. -
max_per_userintegerMost wallets tracked by one user. -
distributionobjectUsers per tracked-wallet count bucket (0,1,2-5, …).
-
-
activeobjectUsers with at least one launch.Child attributes 10
-
usersintegerUsers in the population. -
users_trackingintegerUsers tracking at least one wallet. -
users_tracking_svmintegerUsers tracking a Solana wallet. -
users_tracking_evmintegerUsers tracking an EVM wallet. -
tracked_walletsintegerTracked wallets. -
tracked_svmintegerTracked Solana wallets. -
tracked_evmintegerTracked EVM wallets. -
bookmarkedintegerBookmarked wallets. -
max_per_userintegerMost wallets tracked by one user. -
distributionobjectUsers per tracked-wallet count bucket (0,1,2-5, …).
-
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. |
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.getTrackerStats() src/lib/proxima/endpoints/admin.ts
Retrieve wallet stats
/admin/dashboard/wallets Returns wallet, funding and folder counts, for all users and for active users.
- Token
- Upgraded session token of an account with admin rights.
- Read-only tokens
- Allowed.
- Retry
- Safe to retry
Query parameters
-
min_launchesinteger OptionalLaunch threshold for the*_min_launchescounts.
Returns 200 OK · application/json
-
allobjectEvery non-internal user.Child attributes 3
-
usersintegerUsers in the population. -
scopesobjectsolandevmcover every wallet; an EVM chain id holds the wallets funded or used there. Each scope hasusers_with_wallets,wallets,marketplace,used_wallets,users_min_launches,wallets_min_launches,folder_links,funding(by exchange slug,walletorunfunded) andlaunch_buckets. -
foldersobjectPer scope:users_with_folders,folders,archived.
-
-
activeobjectUsers with at least one launch.Child attributes 3
-
usersintegerUsers in the population. -
scopesobjectsolandevmcover every wallet; an EVM chain id holds the wallets funded or used there. Each scope hasusers_with_wallets,wallets,marketplace,used_wallets,users_min_launches,wallets_min_launches,folder_links,funding(by exchange slug,walletorunfunded) andlaunch_buckets. -
foldersobjectPer scope:users_with_folders,folders,archived.
-
-
min_launchesintegerThreshold applied.
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. |
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.getWalletsStats(params) src/lib/proxima/endpoints/admin.ts
Retrieve sharing stats
/admin/sharing/stats Returns launch-sharing grants, invites, delegated actions and top sharers.
- Token
- Upgraded session token of an account with admin rights.
- Read-only tokens
- Allowed.
- Retry
- Safe to retry
active_* counts are the state right now; the other counts are inside the window.
Query parameters
-
frominteger OptionalWindow start, Unix seconds, inclusive. -
tointeger OptionalWindow end, Unix seconds, inclusive.
Returns 200 OK · application/json
-
windowobjectWindow applied:from,to(nullable),series_from,series_to. -
summaryobjectactive_grants,active_shared_launches,active_sharers,active_members,active_reshares,grants_created,grants_revoked,launches_shared,sharers,members,live_launches. -
invitesobjectPer invite kind (link,direct,request):pending,accepted,declined,revoked,total. -
actionsobjectDelegated calls:total,accepted,refused,unsettled,actors. -
top_sharersarray<object>Licenses sharing the most:license_key,profile,launches,grants,members,active_grants,last_at. -
top_membersarray<object>Licenses receiving the most:license_key,profile,launches,owners,active_grants,actions,last_at. -
recurring_pairsarray<object>Owner and member pairs that share repeatedly:owner,member,launches,last_at. -
recurring_teamsarray<object>Owners sharing with the same members repeatedly:owner,members,launches,last_at. -
permissionsarray<object>Per operation:operation,high_risk,granted(in the window),active(live),calls,accepted,refused. -
seriesarray<object>Per bucket:bucket_start,grants,revokes,actions.
Errors
| Status | Code | When and what to do |
|---|---|---|
| 400 | bad_request | from or to is too large to be read as a date. Send the window bounds in Unix seconds. |
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.getSharingStats(params) src/lib/proxima/endpoints/admin.ts