Dashboard
Aggregate the caller's activity events into volume, fee and count totals.
The dashboard endpoint sums the money and count columns of the caller's activity events over a time window, grouped by the dimensions you choose (day, chain, event type, source, platform, quote mint).
Money comes back as integer strings in raw units: USD amounts in micro-USD, native amounts in the chain's base unit (lamports, wei). A bucket that spans chains adds lamports to wei, so group by chain whenever you read amount_native.
Retrieve dashboard aggregates
/dashboard Returns the caller's activity totals over a window, grouped by the requested dimensions.
- Token
- Upgraded session token, bound to a license.
- Read-only tokens
- Allowed.
- Retry
- Safe to retry
Without since and until, the window is the last 30 days ending now. Without group_by, rows are grouped by event_type.
Query parameters
-
sinceinteger OptionalWindow start in Unix seconds. Defaults to 30 days beforeuntil. -
untilinteger OptionalWindow end in Unix seconds. Defaults to now. -
chainstring OptionalRestrict to one chain ID. -
event_typestring OptionalRestrict to one event type. -
sourcestring OptionalRestrict to one event source. -
group_bystring OptionalComma-separated dimensions:day,chain,event_type,source,platform,quote_mint. The SDK also accepts an array and joins it.Exampleday,chain
Returns 200 OK · application/json
-
fromintegerWindow start used, in Unix seconds. -
tointegerWindow end used, in Unix seconds. -
group_byarray<string>Grouping columns applied.chainis reported aschain_id. -
rowsarray<object>One row per group. Only the grouped dimensions are present.Child attributes 15
-
daystringUTC day (YYYY-MM-DD). -
chain_idstringChain ID. -
event_typestringEvent type. -
sourcestring | nullEvent source. -
platformstring | nullLaunchpad. -
quote_mintstring | nullQuote token mint or address. -
amount_usdstringSum in micro-USD. -
amount_nativestringSum in native base units. -
amount_quotestringSum in quote token base units. -
amount_tokenstringSum in launched-token base units. -
fee_nativestringFees in native base units. Only in the admin variant of this aggregate. -
fee_usdstringFees in micro-USD. Only in the admin variant of this aggregate. -
native_mixedbooleantruewhen the row spans several chains, soamount_nativemixes units. -
count_sumnumberSum of the events' item counts. -
event_countnumberNumber of events in the row.
-
Errors
| Status | Code | When and what to do |
|---|---|---|
| 400 | bad_request | group_by names an unknown dimension. Use day, chain, event_type, source, platform or quote_mint. |
Also the common errors: 401 for a missing or expired session or a base token (license_required) and 429 when rate limited.
Web client proxima.dashboard.getDashboard(params) src/lib/proxima/endpoints/dashboard.ts