# 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.

Base URL: `https://api-mig.proxima.tools`

## Endpoints

- `GET /admin/dashboard`: Retrieve the event dashboard
- `GET /admin/dashboard/summary`: Retrieve the dashboard summary
- `GET /admin/dashboard/series`: Retrieve the dashboard series
- `GET /admin/dashboard/users`: List dashboard users
- `GET /admin/dashboard/users-over-time`: Retrieve top users over time
- `GET /admin/dashboard/heatmap`: Retrieve the activity heatmap
- `GET /admin/dashboard/activity-distribution`: Retrieve the activity distribution
- `GET /admin/dashboard/top-users`: Retrieve top users
- `GET /admin/dashboard/launch-stats`: Retrieve launch stats
- `GET /admin/dashboard/tracker`: Retrieve wallet tracker stats
- `GET /admin/dashboard/wallets`: Retrieve wallet stats
- `GET /admin/sharing/stats`: Retrieve sharing stats

## The Dashboard user object

An account's totals over the requested window.

- `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.

```json
{
  "license_key": "DEMOUSER-k3Jd8QwZp2LmX7vRt",
  "username": "demouser",
  "launch_count": 42,
  "revenue_gross": "20600000000",
  "revenue_net": "17510000000",
  "pnl": "18250000000"
}
```

### Retrieve the event dashboard

`GET /admin/dashboard`

Returns platform event totals, grouped by the dimensions you choose. (Admin JWT · internal)

- 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

- `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.
  - `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

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 400 | `bad_request` | `invalid group_by dimension: <dimension>` | A `group_by` dimension is unknown. | Group by `day`, `chain`, `event_type`, `source`, `platform` or `quote_mint`. |

#### Example request

```bash
curl "https://api-mig.proxima.tools/admin/dashboard" \
  -H "Authorization: Bearer $PROXIMA_JWT"
```

#### Example response

```json
{
  "from": 1792281600,
  "to": 1792368000,
  "group_by": [
    "day",
    "event_type"
  ],
  "rows": [
    {
      "day": "2026-10-16",
      "event_type": "trade.buy",
      "amount_native": "812400000000",
      "amount_usd": "151520000000",
      "fee_native": "0",
      "fee_usd": "0",
      "event_count": 4180,
      "count_sum": 4180
    }
  ]
}
```

### Retrieve the dashboard summary

`GET /admin/dashboard/summary`

Returns headline revenue, P&L, volume, launch and user totals. (Admin JWT · internal)

- 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: `sol`, `eth`, `bsc`, `base`, `robinhood`, `monad`, `arc`, `xlayer`.
- `currency` (enum, optional, default "usd"): Unit of the money amounts. The web app offers `native` only with a `chain_id`. Possible values: `usd`, `native`.
- `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

- `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: `usd`, `native`.
- `native_mixed` (boolean): `true` when native amounts span several chains.
- `units` (object): Unit labels for the amounts in the response.
  - `usd` (string): Unit of the USD amounts.
  - `native` (string): Unit of the native amounts.
  - `time` (string): Unit of the timestamps.

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 400 | `bad_request` | `invalid currency: <currency>` | `currency` is not `usd` or `native`. | Send `currency=usd` or `currency=native`. |
| 429 | `too_many_requests` | `analytics are busy, retry in a minute` | 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` | `analytics are computing, retry in a minute` | 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. |

#### Example request

```bash
curl "https://api-mig.proxima.tools/admin/dashboard/summary" \
  -H "Authorization: Bearer $PROXIMA_JWT"
```

#### Example response

```json
{
  "revenue_gross": "86400000000",
  "revenue_net": "73440000000",
  "referral_paid": "12960000000",
  "users_pnl": "102300000000",
  "total_profit": "148900000000",
  "total_loss": "-46600000000",
  "total_sold": "1912000000000",
  "total_bought": "1809700000000",
  "total_launches": 1284,
  "active_users": 211,
  "total_users": 1630,
  "currency": "usd",
  "native_mixed": false,
  "units": {
    "usd": "micro_usd",
    "native": "lamports",
    "time": "unix_seconds"
  }
}
```

### Retrieve the dashboard series

`GET /admin/dashboard/series`

Returns launches, users, P&L and revenue per time bucket, split by launchpad. (Admin JWT · internal)

- 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: `sol`, `eth`, `bsc`, `base`, `robinhood`, `monad`, `arc`, `xlayer`.
- `currency` (enum, optional, default "usd"): Unit of the money amounts. The web app offers `native` only with a `chain_id`. Possible values: `usd`, `native`.
- `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: `hour`, `day`, `week`, `month`.
- `utc_offset` (integer, optional): Offset from UTC, in hours, for bucket boundaries. The web app leaves it out for UTC+1.

#### Returns 200 OK

- `buckets` (array<object>): One entry per bucket.
  - `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: `hour`, `day`, `week`, `month`.
- `currency` (enum): Unit applied to the money amounts. Possible values: `usd`, `native`.
- `native_mixed` (boolean): `true` when native amounts span several chains.
- `units` (object): Unit labels for the amounts in the response.
  - `usd` (string): Unit of the USD amounts.
  - `native` (string): Unit of the native amounts.
  - `time` (string): Unit of the timestamps.

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 400 | `bad_request` | `invalid granularity: <granularity>` | `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` | `invalid currency: <currency>` | `currency` is not `usd` or `native`. | Send `currency=usd` or `currency=native`. |
| 429 | `too_many_requests` | `analytics are busy, retry in a minute` | 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` | `analytics are computing, retry in a minute` | 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. |

#### Example request

```bash
curl "https://api-mig.proxima.tools/admin/dashboard/series" \
  -H "Authorization: Bearer $PROXIMA_JWT"
```

#### Example response

```json
{
  "buckets": [
    {
      "bucket_start": 1792281600,
      "by_platform": {
        "pumpfun": {
          "launch_count": 31,
          "active_users": 12,
          "pnl": "9100000000",
          "revenue_gross": "6200000000",
          "revenue_net": "5270000000"
        }
      },
      "totals": {
        "launch_count": 31,
        "active_users": 12,
        "pnl": "9100000000",
        "revenue_gross": "6200000000",
        "revenue_net": "5270000000"
      },
      "new_users": 4,
      "total_users": 1630
    }
  ],
  "granularity": "day",
  "currency": "usd",
  "native_mixed": false,
  "units": {
    "usd": "micro_usd",
    "native": "lamports",
    "time": "unix_seconds"
  }
}
```

### List dashboard users

`GET /admin/dashboard/users`

Returns each account's launches, revenue and P&L over the window. (Admin JWT · internal)

- Token: Upgraded session token of an account with admin rights.
- Read-only tokens: allowed.
- Retry: Safe to retry.

> Not called by the current web app.

#### 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: `sol`, `eth`, `bsc`, `base`, `robinhood`, `monad`, `arc`, `xlayer`.
- `currency` (enum, optional, default "usd"): Unit of the money amounts. The web app offers `native` only with a `chain_id`. Possible values: `usd`, `native`.
- `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

- `users` (array<object>): Accounts. See [Dashboard user](#object-dashboard-user).
- `limit` (integer): Applied page size.
- `offset` (integer): Applied offset.
- `currency` (enum): Unit applied to the money amounts. Possible values: `usd`, `native`.
- `native_mixed` (boolean): `true` when native amounts span several chains.
- `units` (object): Unit labels for the amounts in the response.
  - `usd` (string): Unit of the USD amounts.
  - `native` (string): Unit of the native amounts.
  - `time` (string): Unit of the timestamps.

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 400 | `bad_request` | `invalid currency: <currency>` | `currency` is not `usd` or `native`. | Send `currency=usd` or `currency=native`. |
| 429 | `too_many_requests` | `analytics are busy, retry in a minute` | 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` | `analytics are computing, retry in a minute` | 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. |

#### Example request

```bash
curl "https://api-mig.proxima.tools/admin/dashboard/users" \
  -H "Authorization: Bearer $PROXIMA_JWT"
```

#### Example response

```json
{
  "users": [
    {
      "license_key": "DEMOUSER-k3Jd8QwZp2LmX7vRt",
      "username": "demouser",
      "launch_count": 42,
      "revenue_gross": "20600000000",
      "revenue_net": "17510000000",
      "pnl": "18250000000"
    }
  ],
  "limit": 500,
  "offset": 0,
  "currency": "usd",
  "native_mixed": false,
  "units": {
    "usd": "micro_usd",
    "native": "lamports",
    "time": "unix_seconds"
  }
}
```

### Retrieve top users over time

`GET /admin/dashboard/users-over-time`

Returns revenue and launches per bucket for the top accounts, with the rest grouped. (Admin JWT · internal)

- 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: `sol`, `eth`, `bsc`, `base`, `robinhood`, `monad`, `arc`, `xlayer`.
- `currency` (enum, optional, default "usd"): Unit of the money amounts. The web app offers `native` only with a `chain_id`. Possible values: `usd`, `native`.
- `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: `hour`, `day`, `week`, `month`.
- `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: `revenue`, `launches`.
- `top_n` (integer, optional, default "10"): Number of top accounts, 1 to 100.

#### Returns 200 OK

- `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.
  - `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: `hour`, `day`, `week`, `month`.
- `currency` (enum): Unit applied to the money amounts. Possible values: `usd`, `native`.
- `units` (object): Unit labels for the amounts in the response.
  - `usd` (string): Unit of the USD amounts.
  - `native` (string): Unit of the native amounts.
  - `time` (string): Unit of the timestamps.

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 400 | `bad_request` | `invalid granularity: <granularity>` | `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` | `invalid rank_by: <rank_by>` | `rank_by` is not `revenue` or `launches`. | Send `rank_by=revenue` or `rank_by=launches`. |
| 400 | `bad_request` | `invalid currency: <currency>` | `currency` is not `usd` or `native`. | Send `currency=usd` or `currency=native`. |
| 429 | `too_many_requests` | `analytics are busy, retry in a minute` | 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` | `analytics are computing, retry in a minute` | 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. |

#### Example request

```bash
curl "https://api-mig.proxima.tools/admin/dashboard/users-over-time" \
  -H "Authorization: Bearer $PROXIMA_JWT"
```

#### Example response

```json
{
  "top_users": [
    {
      "license_key": "DEMOUSER-k3Jd8QwZp2LmX7vRt",
      "username": "demouser"
    }
  ],
  "others_key": "__others__",
  "buckets": [
    {
      "bucket_start": 1792281600,
      "series": {
        "DEMOUSER-k3Jd8QwZp2LmX7vRt": {
          "revenue_gross": "412000000",
          "revenue_net": "350200000",
          "launches": 3
        },
        "__others__": {
          "revenue_gross": "2860000000",
          "revenue_net": "2431000000",
          "launches": 41
        }
      }
    }
  ],
  "granularity": "day",
  "currency": "usd",
  "units": {
    "usd": "micro_usd",
    "native": "lamports",
    "time": "unix_seconds"
  }
}
```

### Retrieve the activity heatmap

`GET /admin/dashboard/heatmap`

Returns launches, revenue and P&L per weekday and hour. (Admin JWT · internal)

- 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: `sol`, `eth`, `bsc`, `base`, `robinhood`, `monad`, `arc`, `xlayer`.
- `currency` (enum, optional, default "usd"): Unit of the money amounts. The web app offers `native` only with a `chain_id`. Possible values: `usd`, `native`.
- `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

- `cells` (array<object>): One cell per weekday and hour.
  - `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: `usd`, `native`.
- `native_mixed` (boolean): `true` when native amounts span several chains.
- `units` (object): Unit labels for the amounts in the response.
  - `usd` (string): Unit of the USD amounts.
  - `native` (string): Unit of the native amounts.
  - `time` (string): Unit of the timestamps.

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 400 | `bad_request` | `invalid currency: <currency>` | `currency` is not `usd` or `native`. | Send `currency=usd` or `currency=native`. |
| 429 | `too_many_requests` | `analytics are busy, retry in a minute` | 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` | `analytics are computing, retry in a minute` | 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. |

#### Example request

```bash
curl "https://api-mig.proxima.tools/admin/dashboard/heatmap" \
  -H "Authorization: Bearer $PROXIMA_JWT"
```

#### Example response

```json
{
  "cells": [
    {
      "weekday": 2,
      "hour": 15,
      "launch_count": 18,
      "revenue_gross": "1880000000",
      "pnl": "2410000000"
    }
  ],
  "currency": "usd",
  "native_mixed": false,
  "units": {
    "usd": "micro_usd",
    "native": "lamports",
    "time": "unix_seconds"
  }
}
```

### Retrieve the activity distribution

`GET /admin/dashboard/activity-distribution`

Returns how many users made each number of launches, with their revenue. (Admin JWT · internal)

- 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: `sol`, `eth`, `bsc`, `base`, `robinhood`, `monad`, `arc`, `xlayer`.
- `currency` (enum, optional, default "usd"): Unit of the money amounts. The web app offers `native` only with a `chain_id`. Possible values: `usd`, `native`.
- `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

- `rows` (array<object>): One row per distinct launch count, `0` included.
  - `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: `usd`, `native`.
- `native_mixed` (boolean): `true` when native amounts span several chains.

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 400 | `bad_request` | `invalid currency: <currency>` | `currency` is not `usd` or `native`. | Send `currency=usd` or `currency=native`. |
| 429 | `too_many_requests` | `analytics are busy, retry in a minute` | 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` | `analytics are computing, retry in a minute` | 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. |

#### Example request

```bash
curl "https://api-mig.proxima.tools/admin/dashboard/activity-distribution" \
  -H "Authorization: Bearer $PROXIMA_JWT"
```

#### Example response

```json
{
  "rows": [
    {
      "launch_count": 0,
      "user_count": 1419,
      "revenue_gross": "0",
      "revenue_net": "0"
    },
    {
      "launch_count": 1,
      "user_count": 64,
      "revenue_gross": "1920000000",
      "revenue_net": "1632000000"
    }
  ],
  "total_users": 1630,
  "currency": "usd",
  "native_mixed": false
}
```

### Retrieve top users

`GET /admin/dashboard/top-users`

Returns the top accounts by a metric, with everyone else summed. (Admin JWT · internal)

- 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: `sol`, `eth`, `bsc`, `base`, `robinhood`, `monad`, `arc`, `xlayer`.
- `currency` (enum, optional, default "usd"): Unit of the money amounts. The web app offers `native` only with a `chain_id`. Possible values: `usd`, `native`.
- `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: `launches`, `revenue_gross`, `revenue_net`, `pnl`.
- `top_n` (integer, optional): Number of top accounts.

#### Returns 200 OK

- `top` (array<object>): Top accounts. See [Dashboard user](#object-dashboard-user).
- `others` (object): Everyone else, summed.
  - `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: `usd`, `native`.
- `native_mixed` (boolean): `true` when native amounts span several chains.

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 400 | `bad_request` | `invalid rank_by: <rank_by>` | `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` | `invalid currency: <currency>` | `currency` is not `usd` or `native`. | Send `currency=usd` or `currency=native`. |
| 429 | `too_many_requests` | `analytics are busy, retry in a minute` | 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` | `analytics are computing, retry in a minute` | 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. |

#### Example request

```bash
curl "https://api-mig.proxima.tools/admin/dashboard/top-users" \
  -H "Authorization: Bearer $PROXIMA_JWT"
```

#### Example response

```json
{
  "top": [
    {
      "license_key": "DEMOUSER-k3Jd8QwZp2LmX7vRt",
      "username": "demouser",
      "launch_count": 42,
      "revenue_gross": "20600000000",
      "revenue_net": "17510000000",
      "pnl": "18250000000"
    }
  ],
  "others": {
    "user_count": 210,
    "launch_count": 1242,
    "revenue_gross": "65800000000",
    "revenue_net": "55930000000",
    "pnl": "84050000000",
    "pnl_abs": "131200000000"
  },
  "currency": "usd",
  "native_mixed": false
}
```

### Retrieve launch stats

`GET /admin/dashboard/launch-stats`

Returns launch counts and per-launch metrics per period, optionally split by chain or launchpad. (Admin JWT · internal)

- 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: `sol`, `eth`, `bsc`, `base`, `robinhood`, `monad`, `arc`, `xlayer`.
- `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: `hour`, `day`, `week`, `month`.
- `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: `none`, `chain`, `launchpad`.
- `platform` (string, optional): Restricts to one launchpad.

#### Returns 200 OK

- `granularity` (enum): Bucket size applied. Possible values: `hour`, `day`, `week`, `month`.
- `split_by` (enum): Split applied. Possible values: `none`, `chain`, `launchpad`.
- `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.
  - `{split_key}` (object): Totals for one split key from `keys`.
    - `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

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 400 | `bad_request` | `invalid granularity: <granularity>` | `granularity` is not `day`, `week` or `month`. The API refuses `hour`. | Send `granularity` as `day`, `week` or `month`. |
| 400 | `bad_request` | `invalid split_by: <split_by>` | `split_by` is not `none`, `chain` or `launchpad`. | Send `split_by` as `none`, `chain` or `launchpad`. |
| 400 | `bad_request` | `range too long for this granularity` | The window spans 1500 buckets or more at this granularity. | Shorten the window or use a coarser `granularity`. |
| 429 | `too_many_requests` | `analytics are busy, retry in a minute` | 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. |

#### Example request

```bash
curl "https://api-mig.proxima.tools/admin/dashboard/launch-stats" \
  -H "Authorization: Bearer $PROXIMA_JWT"
```

#### Example response

```json
{
  "granularity": "day",
  "split_by": "none",
  "keys": [
    "all"
  ],
  "periods": [
    {
      "period": 1792281600,
      "cells": {
        "all": {
          "launches": 44,
          "counts": {
            "method:mev": 30,
            "origin:imported": 2
          },
          "metrics": {
            "all": {
              "active_holders": [
                5280,
                44
              ]
            }
          }
        }
      }
    }
  ],
  "totals": {
    "all": {
      "launches": 44,
      "counts": {
        "method:mev": 30,
        "origin:imported": 2
      },
      "metrics": {
        "all": {
          "active_holders": [
            5280,
            44
          ]
        }
      }
    }
  }
}
```

### Retrieve wallet tracker stats

`GET /admin/dashboard/tracker`

Returns wallet tracker adoption, for all users and for active users. (Admin JWT · internal)

- 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.

#### Returns 200 OK

- `all` (object): Every non-internal user.
  - `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.
  - `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

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 429 | `too_many_requests` | `analytics are busy, retry in a minute` | 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. |

#### Example request

```bash
curl "https://api-mig.proxima.tools/admin/dashboard/tracker" \
  -H "Authorization: Bearer $PROXIMA_JWT"
```

#### Example response

```json
{
  "all": {
    "users": 1630,
    "users_tracking": 402,
    "users_tracking_svm": 377,
    "users_tracking_evm": 88,
    "tracked_wallets": 5120,
    "tracked_svm": 4610,
    "tracked_evm": 510,
    "bookmarked": 930,
    "max_per_user": 250,
    "distribution": {
      "0": 1228,
      "1": 96,
      "2-5": 171
    }
  },
  "active": {
    "users": 211,
    "users_tracking": 140,
    "users_tracking_svm": 131,
    "users_tracking_evm": 40,
    "tracked_wallets": 2980,
    "tracked_svm": 2700,
    "tracked_evm": 280,
    "bookmarked": 512,
    "max_per_user": 250,
    "distribution": {
      "0": 71,
      "1": 22,
      "2-5": 60
    }
  }
}
```

### Retrieve wallet stats

`GET /admin/dashboard/wallets`

Returns wallet, funding and folder counts, for all users and for active users. (Admin JWT · internal)

- 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

- `all` (object): Every non-internal user.
  - `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.
  - `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

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 429 | `too_many_requests` | `analytics are busy, retry in a minute` | 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. |

#### Example request

```bash
curl "https://api-mig.proxima.tools/admin/dashboard/wallets" \
  -H "Authorization: Bearer $PROXIMA_JWT"
```

#### Example response

```json
{
  "all": {
    "users": 1630,
    "scopes": {
      "sol": {
        "users_with_wallets": 980,
        "wallets": 48200,
        "marketplace": 3100,
        "used_wallets": 31400,
        "users_min_launches": 140,
        "wallets_min_launches": 22800,
        "folder_links": 9100,
        "funding": {
          "wallet": 27000,
          "unfunded": 16900,
          "binance": 4300
        },
        "launch_buckets": {
          "0": 16800,
          "1": 9200,
          "2-5": 14100
        }
      }
    },
    "folders": {
      "sol": {
        "users_with_folders": 410,
        "folders": 2240,
        "archived": 380
      }
    }
  },
  "active": {
    "users": 211,
    "scopes": {
      "sol": {
        "users_with_wallets": 205,
        "wallets": 30100,
        "marketplace": 2400,
        "used_wallets": 26900,
        "users_min_launches": 140,
        "wallets_min_launches": 22800,
        "folder_links": 7600,
        "funding": {
          "wallet": 19800,
          "unfunded": 7400,
          "binance": 2900
        },
        "launch_buckets": {
          "0": 3200,
          "1": 7400,
          "2-5": 12500
        }
      }
    },
    "folders": {
      "sol": {
        "users_with_folders": 180,
        "folders": 1310,
        "archived": 240
      }
    }
  },
  "min_launches": 5
}
```

### Retrieve sharing stats

`GET /admin/sharing/stats`

Returns launch-sharing grants, invites, delegated actions and top sharers. (Admin JWT · internal)

- 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

- `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

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 400 | `bad_request` | `<field> is not a unix-seconds timestamp: <value>` | `from` or `to` is too large to be read as a date. | Send the window bounds in Unix seconds. |

#### Example request

```bash
curl "https://api-mig.proxima.tools/admin/sharing/stats" \
  -H "Authorization: Bearer $PROXIMA_JWT"
```

#### Example response

```json
{
  "window": {
    "from": 1791763200,
    "to": 1792368000,
    "series_from": 1791763200,
    "series_to": 1792368000
  },
  "summary": {
    "active_grants": 84,
    "active_shared_launches": 51,
    "active_sharers": 33,
    "active_members": 47,
    "active_reshares": 6,
    "grants_created": 19,
    "grants_revoked": 4,
    "launches_shared": 15,
    "sharers": 11,
    "members": 16,
    "live_launches": 9
  },
  "invites": {
    "link": {
      "pending": 3,
      "accepted": 12,
      "declined": 1,
      "revoked": 2,
      "total": 18
    }
  },
  "actions": {
    "total": 640,
    "accepted": 611,
    "refused": 29,
    "unsettled": 0,
    "actors": 21
  },
  "top_sharers": [
    {
      "license_key": "DEMOUSER-k3Jd8QwZp2LmX7vRt",
      "profile": {
        "username": "demouser",
        "display_name": "Demo User",
        "avatar_url": null
      },
      "launches": 6,
      "grants": 9,
      "members": 4,
      "active_grants": 7,
      "last_at": 1792350000
    }
  ],
  "top_members": [
    {
      "license_key": "SAMPLEDEV-Hy6Rk1Ws9Jd3Fq8Lp",
      "profile": {
        "username": "sampledev",
        "display_name": null,
        "avatar_url": null
      },
      "launches": 5,
      "owners": 2,
      "active_grants": 5,
      "actions": 140,
      "last_at": 1792351000
    }
  ],
  "recurring_pairs": [],
  "recurring_teams": [],
  "permissions": [
    {
      "operation": "sell",
      "high_risk": false,
      "granted": 17,
      "active": 80,
      "calls": 402,
      "accepted": 395,
      "refused": 7
    }
  ],
  "series": [
    {
      "bucket_start": 1792281600,
      "grants": 3,
      "revokes": 1,
      "actions": 96
    }
  ]
}
```
