Skip to content
API Reference

Search is only available in production builds. Try building and previewing the site to test it out locally.

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.

An account's totals over the requested window.

Attributes

  • license_key string
    License key.
  • username string
    Username.
  • launch_count integer
    Launches in the window.
  • revenue_gross string
    Fees paid, in the requested currency (micro-USD, or lamports or wei), as an integer string.
  • revenue_net string
    Fees after referral, in the requested currency (micro-USD, or lamports or wei), as an integer string.
  • pnl string
    Launch P&L, in the requested currency (micro-USD, or lamports or wei), as an integer string.

Retrieve the event dashboard

Admin JWT internal
GET /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

  • since integer Optional
    Window start, Unix seconds.
  • until integer Optional
    Window end, Unix seconds.
  • chain string Optional
    Restricts to one chain.
  • event_type string Optional
    Restricts to one event type, such as trade.buy.
  • source string Optional
    Restricts to one event source.
  • group_by string Optional
    Comma-separated dimensions: day, chain, event_type, source, platform, quote_mint.

Returns 200 OK · application/json

  • from integer
    Window start applied, Unix seconds.
  • to integer
    Window end applied, Unix seconds.
  • group_by array<string>
    Dimensions applied.
  • rows array<object>
    One row per group. Only the grouped dimensions are present.
    Child attributes 14
    • day string
      Day, when grouped by day.
    • chain_id string
      Chain, when grouped by chain.
    • event_type string
      Event type, when grouped by event_type.
    • source string | null
      Source, when grouped by source.
    • platform string | null
      Launchpad, when grouped by platform.
    • quote_mint string | null
      Quote token, when grouped by quote_mint.
    • amount_native string
      Native amount, in lamports or wei, as an integer string.
    • amount_quote string
      Quote token amount, as an integer string.
    • amount_usd string
      USD amount, in micro-USD, as an integer string.
    • amount_token string
      Token amount, as an integer string.
    • fee_native string
      Fees, in lamports or wei, as an integer string.
    • fee_usd string
      Fees, in micro-USD, as an integer string.
    • event_count integer
      Number of events.
    • count_sum integer
      Sum of the events' counts.

Errors

StatusCodeWhen 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 JWT internal
GET /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_at integer Optional
    Window start, Unix seconds, inclusive. Filters on launch time.
  • end_at integer Optional
    Window end, Unix seconds, inclusive.
  • chain_id enum Optional
    Restricts to one chain. all is not sent.
    Possible values solethbscbaserobinhoodmonadarcxlayer
  • currency enum Optional Default usd
    Unit of the money amounts. The web app offers native only with a chain_id.
    Possible values usdnative
  • include_archived boolean Optional Default true
    Counts archived launches.
  • count_group_members boolean Optional Default false
    Counts launches that belong to a launch group.

Returns 200 OK · application/json

  • revenue_gross string
    Fees paid to Proxima, in the requested currency (micro-USD, or lamports or wei), as an integer string.
  • revenue_net string
    Fees after referral, in the requested currency (micro-USD, or lamports or wei), as an integer string.
  • referral_paid string
    Referral paid, in the requested currency (micro-USD, or lamports or wei), as an integer string.
  • users_pnl string
    Users' combined launch P&L, in the requested currency (micro-USD, or lamports or wei), as an integer string.
  • total_profit string
    Sum of positive P&L, in the requested currency (micro-USD, or lamports or wei), as an integer string.
  • total_loss string
    Sum of negative P&L, in the requested currency (micro-USD, or lamports or wei), as an integer string.
  • total_sold string
    Volume sold, in the requested currency (micro-USD, or lamports or wei), as an integer string.
  • total_bought string
    Volume bought, in the requested currency (micro-USD, or lamports or wei), as an integer string.
  • total_launches integer
    Launches in the window.
  • active_users integer
    Users with a launch in the window.
  • total_users integer
    All users.
  • currency enum
    Unit applied to the money amounts.
    Possible values usdnative
  • native_mixed boolean
    true when native amounts span several chains.
  • units object
    Unit labels for the amounts in the response.
    Child attributes 3
    • usd string
      Unit of the USD amounts.
    • native string
      Unit of the native amounts.
    • time string
      Unit of the timestamps.

Errors

StatusCodeWhen 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 JWT internal
GET /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_at integer Optional
    Window start, Unix seconds, inclusive. Filters on launch time.
  • end_at integer Optional
    Window end, Unix seconds, inclusive.
  • chain_id enum Optional
    Restricts to one chain. all is not sent.
    Possible values solethbscbaserobinhoodmonadarcxlayer
  • currency enum Optional Default usd
    Unit of the money amounts. The web app offers native only with a chain_id.
    Possible values usdnative
  • include_archived boolean Optional Default true
    Counts archived launches.
  • count_group_members boolean Optional Default false
    Counts launches that belong to a launch group.
  • granularity enum Optional Default day
    Bucket size. The API refuses hour.
    Possible values hourdayweekmonth
  • utc_offset integer Optional
    Offset from UTC, in hours, for bucket boundaries. The web app leaves it out for UTC+1.

Returns 200 OK · application/json

  • buckets array<object>
    One entry per bucket.
    Child attributes 5
    • bucket_start integer
      Bucket start, Unix seconds.
    • by_platform object
      Stats per launchpad id: launch_count, active_users, pnl, revenue_gross, revenue_net.
    • totals object
      Same stats across launchpads.
    • new_users integer
      Accounts created in the bucket.
    • total_users integer
      Accounts at the end of the bucket.
  • granularity enum
    Bucket size applied.
    Possible values hourdayweekmonth
  • currency enum
    Unit applied to the money amounts.
    Possible values usdnative
  • native_mixed boolean
    true when native amounts span several chains.
  • units object
    Unit labels for the amounts in the response.
    Child attributes 3
    • usd string
      Unit of the USD amounts.
    • native string
      Unit of the native amounts.
    • time string
      Unit of the timestamps.

Errors

StatusCodeWhen 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 JWT internal
GET /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_at integer Optional
    Window start, Unix seconds, inclusive. Filters on launch time.
  • end_at integer Optional
    Window end, Unix seconds, inclusive.
  • chain_id enum Optional
    Restricts to one chain. all is not sent.
    Possible values solethbscbaserobinhoodmonadarcxlayer
  • currency enum Optional Default usd
    Unit of the money amounts. The web app offers native only with a chain_id.
    Possible values usdnative
  • include_archived boolean Optional Default true
    Counts archived launches.
  • count_group_members boolean Optional Default false
    Counts launches that belong to a launch group.
  • limit integer Optional Default 500
    Page size. The API defaults to 500 and caps at 2000.
  • offset integer Optional Default 0
    Number of rows to skip.
  • include_inactive boolean Optional Default false
    Includes accounts with no launch in the window.

Returns 200 OK · application/json

  • users array<object>
    Accounts. See Dashboard user.
  • limit integer
    Applied page size.
  • offset integer
    Applied offset.
  • currency enum
    Unit applied to the money amounts.
    Possible values usdnative
  • native_mixed boolean
    true when native amounts span several chains.
  • units object
    Unit labels for the amounts in the response.
    Child attributes 3
    • usd string
      Unit of the USD amounts.
    • native string
      Unit of the native amounts.
    • time string
      Unit of the timestamps.

Errors

StatusCodeWhen 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 JWT internal
GET /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_at integer Optional
    Window start, Unix seconds, inclusive. Filters on launch time.
  • end_at integer Optional
    Window end, Unix seconds, inclusive.
  • chain_id enum Optional
    Restricts to one chain. all is not sent.
    Possible values solethbscbaserobinhoodmonadarcxlayer
  • currency enum Optional Default usd
    Unit of the money amounts. The web app offers native only with a chain_id.
    Possible values usdnative
  • include_archived boolean Optional Default true
    Counts archived launches.
  • count_group_members boolean Optional Default false
    Counts launches that belong to a launch group.
  • granularity enum Optional Default day
    Bucket size. The API refuses hour.
    Possible values hourdayweekmonth
  • utc_offset integer Optional
    Offset from UTC, in hours, for bucket boundaries. The web app leaves it out for UTC+1.
  • rank_by enum Optional Default revenue
    Ranking.
    Possible values revenuelaunches
  • top_n integer Optional Default 10
    Number of top accounts, 1 to 100.

Returns 200 OK · application/json

  • top_users array<object>
    Top accounts: license_key, username.
  • others_key string
    Series key of the grouped remainder. Never a license key.
  • buckets array<object>
    One entry per bucket.
    Child attributes 2
    • bucket_start integer
      Bucket start, Unix seconds.
    • series object
      Per license key (and others_key): revenue_gross, revenue_net, launches.
  • granularity enum
    Bucket size applied.
    Possible values hourdayweekmonth
  • currency enum
    Unit applied to the money amounts.
    Possible values usdnative
  • units object
    Unit labels for the amounts in the response.
    Child attributes 3
    • usd string
      Unit of the USD amounts.
    • native string
      Unit of the native amounts.
    • time string
      Unit of the timestamps.

Errors

StatusCodeWhen 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 JWT internal
GET /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_at integer Optional
    Window start, Unix seconds, inclusive. Filters on launch time.
  • end_at integer Optional
    Window end, Unix seconds, inclusive.
  • chain_id enum Optional
    Restricts to one chain. all is not sent.
    Possible values solethbscbaserobinhoodmonadarcxlayer
  • currency enum Optional Default usd
    Unit of the money amounts. The web app offers native only with a chain_id.
    Possible values usdnative
  • include_archived boolean Optional Default true
    Counts archived launches.
  • count_group_members boolean Optional Default false
    Counts launches that belong to a launch group.
  • utc_offset integer Optional
    Offset from UTC, in hours, for bucket boundaries. The web app leaves it out for UTC+1.

Returns 200 OK · application/json

  • cells array<object>
    One cell per weekday and hour.
    Child attributes 5
    • weekday integer
      Day of the week, 0 (Monday) to 6 (Sunday).
    • hour integer
      Hour, 0 to 23.
    • launch_count integer
      Launches.
    • revenue_gross string
      Fees paid, in the requested currency (micro-USD, or lamports or wei), as an integer string.
    • pnl string
      Launch P&L, in the requested currency (micro-USD, or lamports or wei), as an integer string.
  • currency enum
    Unit applied to the money amounts.
    Possible values usdnative
  • native_mixed boolean
    true when native amounts span several chains.
  • units object
    Unit labels for the amounts in the response.
    Child attributes 3
    • usd string
      Unit of the USD amounts.
    • native string
      Unit of the native amounts.
    • time string
      Unit of the timestamps.

Errors

StatusCodeWhen 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

GET /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_at integer Optional
    Window start, Unix seconds, inclusive. Filters on launch time.
  • end_at integer Optional
    Window end, Unix seconds, inclusive.
  • chain_id enum Optional
    Restricts to one chain. all is not sent.
    Possible values solethbscbaserobinhoodmonadarcxlayer
  • currency enum Optional Default usd
    Unit of the money amounts. The web app offers native only with a chain_id.
    Possible values usdnative
  • include_archived boolean Optional Default true
    Counts archived launches.
  • count_group_members boolean Optional Default false
    Counts launches that belong to a launch group.

Returns 200 OK · application/json

  • rows array<object>
    One row per distinct launch count, 0 included.
    Child attributes 4
    • launch_count integer
      Launches per user.
    • user_count integer
      Users with that many launches.
    • revenue_gross string
      Fees paid, in the requested currency (micro-USD, or lamports or wei), as an integer string.
    • revenue_net string
      Fees after referral, in the requested currency (micro-USD, or lamports or wei), as an integer string.
  • total_users integer
    Users counted.
  • currency enum
    Unit applied to the money amounts.
    Possible values usdnative
  • native_mixed boolean
    true when native amounts span several chains.

Errors

StatusCodeWhen 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 JWT internal
GET /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_at integer Optional
    Window start, Unix seconds, inclusive. Filters on launch time.
  • end_at integer Optional
    Window end, Unix seconds, inclusive.
  • chain_id enum Optional
    Restricts to one chain. all is not sent.
    Possible values solethbscbaserobinhoodmonadarcxlayer
  • currency enum Optional Default usd
    Unit of the money amounts. The web app offers native only with a chain_id.
    Possible values usdnative
  • include_archived boolean Optional Default true
    Counts archived launches.
  • count_group_members boolean Optional Default false
    Counts launches that belong to a launch group.
  • rank_by enum Optional
    Ranking metric.
    Possible values launchesrevenue_grossrevenue_netpnl
  • top_n integer Optional
    Number of top accounts.

Returns 200 OK · application/json

  • top array<object>
    Top accounts. See Dashboard user.
  • others object
    Everyone else, summed.
    Child attributes 6
    • user_count integer
      Users.
    • launch_count integer
      Launches.
    • revenue_gross string
      Fees paid, in the requested currency (micro-USD, or lamports or wei), as an integer string.
    • revenue_net string
      Fees after referral, in the requested currency (micro-USD, or lamports or wei), as an integer string.
    • pnl string
      Launch P&L, in the requested currency (micro-USD, or lamports or wei), as an integer string.
    • pnl_abs string
      Sum of absolute P&L, in the requested currency (micro-USD, or lamports or wei), as an integer string.
  • currency enum
    Unit applied to the money amounts.
    Possible values usdnative
  • native_mixed boolean
    true when native amounts span several chains.

Errors

StatusCodeWhen 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 JWT internal
GET /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_at integer Optional
    Window start, Unix seconds, inclusive. Filters on launch time.
  • end_at integer Optional
    Window end, Unix seconds, inclusive.
  • chain_id enum Optional
    Restricts to one chain. all is not sent.
    Possible values solethbscbaserobinhoodmonadarcxlayer
  • include_archived boolean Optional Default true
    Counts archived launches.
  • count_group_members boolean Optional Default false
    Counts launches that belong to a launch group.
  • granularity enum Optional Default day
    Bucket size. The API refuses hour.
    Possible values hourdayweekmonth
  • utc_offset integer Optional
    Offset from UTC, in hours, for bucket boundaries. The web app leaves it out for UTC+1.
  • split_by enum Optional
    Split dimension.
    Possible values nonechainlaunchpad
  • platform string Optional
    Restricts to one launchpad.

Returns 200 OK · application/json

  • granularity enum
    Bucket size applied.
    Possible values hourdayweekmonth
  • split_by enum
    Split applied.
    Possible values nonechainlaunchpad
  • keys array<string>
    Split keys, most launches first. all when unsplit.
  • periods array<object>
    One entry per period: period (Unix seconds) and cells keyed by split key, or null when empty.
  • totals object
    Cells over the whole window, keyed by split key.
    Child attributes 4
    • {split_key} object
      Totals for one split key from keys.
      Child attributes 3
      • launches integer
        Launches.
      • counts object
        Counts by tag, such as method:mev, origin:imported, schedule:scheduled, mev_type:atomic, funding_type:cex.
      • metrics object
        Keyed by launch method (all included), then metric name, to a [sum, samples] pair.

Errors

StatusCodeWhen 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 JWT internal
GET /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

  • all object
    Every non-internal user.
    Child attributes 10
    • users integer
      Users in the population.
    • users_tracking integer
      Users tracking at least one wallet.
    • users_tracking_svm integer
      Users tracking a Solana wallet.
    • users_tracking_evm integer
      Users tracking an EVM wallet.
    • tracked_wallets integer
      Tracked wallets.
    • tracked_svm integer
      Tracked Solana wallets.
    • tracked_evm integer
      Tracked EVM wallets.
    • bookmarked integer
      Bookmarked wallets.
    • max_per_user integer
      Most wallets tracked by one user.
    • distribution object
      Users per tracked-wallet count bucket (0, 1, 2-5, …).
  • active object
    Users with at least one launch.
    Child attributes 10
    • users integer
      Users in the population.
    • users_tracking integer
      Users tracking at least one wallet.
    • users_tracking_svm integer
      Users tracking a Solana wallet.
    • users_tracking_evm integer
      Users tracking an EVM wallet.
    • tracked_wallets integer
      Tracked wallets.
    • tracked_svm integer
      Tracked Solana wallets.
    • tracked_evm integer
      Tracked EVM wallets.
    • bookmarked integer
      Bookmarked wallets.
    • max_per_user integer
      Most wallets tracked by one user.
    • distribution object
      Users per tracked-wallet count bucket (0, 1, 2-5, …).

Errors

StatusCodeWhen 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 JWT internal
GET /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_launches integer Optional
    Launch threshold for the *_min_launches counts.

Returns 200 OK · application/json

  • all object
    Every non-internal user.
    Child attributes 3
    • users integer
      Users in the population.
    • scopes object
      sol and evm cover every wallet; an EVM chain id holds the wallets funded or used there. Each scope has users_with_wallets, wallets, marketplace, used_wallets, users_min_launches, wallets_min_launches, folder_links, funding (by exchange slug, wallet or unfunded) and launch_buckets.
    • folders object
      Per scope: users_with_folders, folders, archived.
  • active object
    Users with at least one launch.
    Child attributes 3
    • users integer
      Users in the population.
    • scopes object
      sol and evm cover every wallet; an EVM chain id holds the wallets funded or used there. Each scope has users_with_wallets, wallets, marketplace, used_wallets, users_min_launches, wallets_min_launches, folder_links, funding (by exchange slug, wallet or unfunded) and launch_buckets.
    • folders object
      Per scope: users_with_folders, folders, archived.
  • min_launches integer
    Threshold applied.

Errors

StatusCodeWhen 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 JWT internal
GET /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

  • from integer Optional
    Window start, Unix seconds, inclusive.
  • to integer Optional
    Window end, Unix seconds, inclusive.

Returns 200 OK · application/json

  • window object
    Window applied: from, to (nullable), series_from, series_to.
  • summary object
    active_grants, active_shared_launches, active_sharers, active_members, active_reshares, grants_created, grants_revoked, launches_shared, sharers, members, live_launches.
  • invites object
    Per invite kind (link, direct, request): pending, accepted, declined, revoked, total.
  • actions object
    Delegated calls: total, accepted, refused, unsettled, actors.
  • top_sharers array<object>
    Licenses sharing the most: license_key, profile, launches, grants, members, active_grants, last_at.
  • top_members array<object>
    Licenses receiving the most: license_key, profile, launches, owners, active_grants, actions, last_at.
  • recurring_pairs array<object>
    Owner and member pairs that share repeatedly: owner, member, launches, last_at.
  • recurring_teams array<object>
    Owners sharing with the same members repeatedly: owner, members, launches, last_at.
  • permissions array<object>
    Per operation: operation, high_risk, granted (in the window), active (live), calls, accepted, refused.
  • series array<object>
    Per bucket: bucket_start, grants, revokes, actions.

Errors

StatusCodeWhen 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