# Activity history

> Page through the activity events recorded for an account, a launch, or the system.

Every significant action is recorded as an **activity event**: launches and deploys, trades, automation runs, withdrawals, wallet and key operations, funding, account changes. Each event has an `event_type`, an optional chain and launch, and an event-specific `payload`.

The feeds are cursor-paginated, newest first. Pass `cursor=0` for the first page, then the previous page's `next_cursor` until it is `null`. Event `id` and `launch_ext_id` are 64-bit integers sent and kept as strings.

In the web app these feed the **Logs** page, the history panel of a live launch, the funder history and the admin system logs.

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

## Endpoints

- `GET /history`: List activity events
- `GET /history/launch/{launch_id}`: List a launch's activity events
- `GET /admin/system-events`: List system events

## The Activity event object

One recorded action.

- `id` (string): 64-bit event ID as a string. Also the pagination cursor.
- `created_at` (integer): Time of the event in Unix seconds (UTC).
- `license_key` (string | null): License the event belongs to; `null` for system events. Declared by the client type; the current backend does not send it.
- `event_type` (string): Dotted event type. Families: `launch.*`, `buy`, `withdraw`, `autobuy.*`, `autosell.*`, `volume.*`, `fake_volume.*`, `cleanup.*`, `sniper_guard.*`, `mm.*`, `wallet.*`, `keys.*`, `funding.*`, `shield.*`, `staking.*`, `referral.claim`, `auth.*`, `marketplace.purchase`, `admin.*`, `system.*`.
- `chain_id` (enum | null): Chain of the event, or `null`. Possible values: `sol`, `bsc`, `eth`, `base`, `robinhood`, `arc`, `xlayer`.
- `launch_ext_id` (string | null): Launch `ext_id` as a string, or `null` when the event is not tied to a launch.
- `payload` (object): Event-specific data. Keys depend on `event_type`; atomic amounts are integer strings.
  - `tx_hashes` (array<string>): Transactions the action sent.
  - `transfers` (array<object>): Per-wallet legs with `wallet`, `tx_hash`, `status` (`success`, `failed`, `planned`, `skipped`) and amounts.
  - `mint` (string | null): Token mint or contract address involved.
  - `platform` (string): Launchpad involved.
  - `amount_native_atomic` (string): Native amount in base units (lamports, wei).
  - `origin` (enum): On `withdraw` events: which wallets were drained. `license_wallets` is the legacy spelling of `global`. Possible values: `launch`, `aged`, `global`, `license_wallets`.
  - `status` (string): On `withdraw` events: lifecycle status, e.g. `collecting`, `settling`, `completed`.

```json
{
  "id": "884213",
  "created_at": 1793614500,
  "event_type": "launch.deploy_mev",
  "chain_id": "sol",
  "launch_ext_id": "101920010239643",
  "payload": {
    "tx_hashes": [
      "NeC5ayJvChpkwNvpzKBU8aBUhvPMw6EEL21rEz1dB3PVBcWo5L6tDk3fGwhRdQnkPeRS5A19mCBPgsddwAdyM8ND"
    ],
    "mint": "Fe7dTUwYvLw7znvXqijANZgztiDVWiE4J3cjDs6RiaZ",
    "platform": "pumpfun",
    "holder_count": 12,
    "front_mev_count": 2
  }
}
```

### List activity events

`GET /history`

Lists the caller's activity events, newest first. (Bearer JWT)

- Token: Upgraded session token, bound to a license.
- Read-only tokens: allowed.
- Retry: Safe to retry.

Backs the **Logs** page and the funder history. The SDK always sends `cursor`, using `0` for the first page; the app requests 50 events per page.

> `id` and `launch_ext_id` can exceed 2^53. They arrive as strings, and the client also rewrites them to strings if a bare number appears, so never parse them as JavaScript numbers.

#### Query parameters

- `cursor` (string, required, default "0"): `next_cursor` of the previous page, or `0` for the first page.
- `limit` (integer, optional, default "50"): Events per page, from 1 to 100.
- `type` (string, optional): Comma-separated event types to include, e.g. `launch.create,launch.deploy_mev`.
- `launch_ext_id` (string, optional): Restrict to one launch.
- `chain` (enum, optional): Restrict to one chain. Possible values: `sol`, `bsc`, `eth`, `base`, `robinhood`, `xlayer`.
- `since` (string, optional): Lower bound on `created_at` in Unix seconds, inclusive.
- `until` (string, optional): Upper bound on `created_at` in Unix seconds, inclusive.

#### Returns 200 OK

- `events` (array<object>): [Activity event](#object-activity-event) objects.
- `next_cursor` (string | null): Cursor for the next page, or `null` when there are no more events.

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 400 | `bad_request` | `invalid chain '<chain>' (expected sol\|bsc\|eth\|base\|robinhood\|xlayer)` | `chain` is not one of the supported chains. | Send `sol`, `bsc`, `eth`, `base`, `robinhood` or `xlayer`, or omit `chain`. |
| 400 | `bad_request` | `invalid cursor (must be an int64)` | `cursor` is not a 64-bit integer. | Send `0` for the first page, then the previous page's `next_cursor`. |
| 400 | `bad_request` | `invalid launch_ext_id (must be an int64)` | `launch_ext_id` is not a 64-bit integer. | Send the launch `ext_id` as a decimal string. |

#### Example request

```bash
curl "https://api-mig.proxima.tools/history?cursor=0&since=1790985600&until=1793663999" \
  -H "Authorization: Bearer $PROXIMA_JWT"
```

#### Example response

```json
{
  "events": [
    {
      "id": "884213",
      "created_at": 1793614500,
      "event_type": "launch.deploy_mev",
      "chain_id": "sol",
      "launch_ext_id": "101920010239643",
      "payload": {
        "tx_hashes": [
          "NeC5ayJvChpkwNvpzKBU8aBUhvPMw6EEL21rEz1dB3PVBcWo5L6tDk3fGwhRdQnkPeRS5A19mCBPgsddwAdyM8ND"
        ],
        "mint": "Fe7dTUwYvLw7znvXqijANZgztiDVWiE4J3cjDs6RiaZ",
        "platform": "pumpfun"
      }
    },
    {
      "id": "884207",
      "created_at": 1793613492,
      "event_type": "withdraw",
      "chain_id": "sol",
      "launch_ext_id": null,
      "payload": {
        "origin": "global",
        "status": "completed",
        "src_asset": "native",
        "amount_native_atomic": "2500000000"
      }
    }
  ],
  "next_cursor": "884207"
}
```

### List a launch's activity events

`GET /history/launch/{launch_id}`

Lists the activity events of one launch, newest first. (Bearer JWT)

- Token: Upgraded session token, bound to a license.
- Read-only tokens: allowed.
- Retry: Safe to retry.

Backs the history panel of a live launch, which refreshes it every 2 seconds. Takes the same query parameters as [List activity events](#list-events) except `launch_ext_id`; the path wins.

> On a launch shared through Launch Sharing, a grantee with `history.read` receives the events with `payload` removed.

> A launch the caller neither owns nor holds a share on answers an empty page, not `404`.

#### Path parameters

- `launch_id` (string, required): The launch `ext_id`.

#### Query parameters

- `cursor` (string, required, default "0"): `next_cursor` of the previous page, or `0` for the first page.
- `limit` (integer, optional, default "50"): Events per page, from 1 to 100.
- `type` (string, optional): Comma-separated event types to include.
- `chain` (enum, optional): Restrict to one chain. Possible values: `sol`, `bsc`, `eth`, `base`, `robinhood`, `xlayer`.
- `since` (string, optional): Lower bound in Unix seconds, inclusive.
- `until` (string, optional): Upper bound in Unix seconds, inclusive.

#### Returns 200 OK

- `events` (array<object>): [Activity event](#object-activity-event) objects.
- `next_cursor` (string | null): Cursor for the next page, or `null`.

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 400 | `bad_request` | `invalid launch_ext_id (must be an int64)` | The launch ID in the path is not a 64-bit integer. | Pass the launch `ext_id` as a decimal string. |
| 400 | `bad_request` | `invalid chain '<chain>' (expected sol\|bsc\|eth\|base\|robinhood\|xlayer)` | `chain` is not one of the supported chains. | Send `sol`, `bsc`, `eth`, `base`, `robinhood` or `xlayer`, or omit `chain`. |
| 400 | `bad_request` | `invalid cursor (must be an int64)` | `cursor` is not a 64-bit integer. | Send `0` for the first page, then the previous page's `next_cursor`. |
| 403 | `forbidden` | `this share does not carry 'history.read'` | The caller reaches the launch through a share that does not carry `history.read`. | Ask the owner to add `history.read` to your grant. |

#### Example request

```bash
curl "https://api-mig.proxima.tools/history/launch/101920010239643?cursor=0" \
  -H "Authorization: Bearer $PROXIMA_JWT"
```

#### Example response

```json
{
  "events": [
    {
      "id": "884230",
      "created_at": 1793614504,
      "event_type": "autosell.run",
      "chain_id": "sol",
      "launch_ext_id": "101920010239643",
      "payload": {
        "session_id": "f5281570-a530-4505-b29e-b5e2b64ea166",
        "wallet_count": 8
      }
    }
  ],
  "next_cursor": null
}
```

### List system events

`GET /admin/system-events`

Lists events recorded by the platform itself rather than by an account. (Admin JWT · internal)

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

Backs the admin **Logs** page. Returns only events with no license, such as `system.boot` and `system.session_restart.*`. Takes the same query parameters as [List activity events](#list-events) except `launch_ext_id`.

#### Query parameters

- `cursor` (string, required, default "0"): `next_cursor` of the previous page, or `0` for the first page.
- `limit` (integer, optional, default "50"): Events per page, from 1 to 100.
- `type` (string, optional): Comma-separated event types to include.
- `chain` (enum, optional): Restrict to one chain. Possible values: `sol`, `bsc`, `eth`, `base`, `robinhood`, `xlayer`.
- `since` (string, optional): Lower bound in Unix seconds, inclusive.
- `until` (string, optional): Upper bound in Unix seconds, inclusive.

#### Returns 200 OK

- `events` (array<object>): [Activity event](#object-activity-event) objects.
- `next_cursor` (string | null): Cursor for the next page, or `null`.
- `dropped_total` (integer): Events the writer has shed since start because its queue was full. Not read by the web app.

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 400 | `bad_request` | `invalid chain '<chain>' (expected sol\|bsc\|eth\|base\|robinhood\|xlayer)` | `chain` is not one of the supported chains. | Send `sol`, `bsc`, `eth`, `base`, `robinhood` or `xlayer`, or omit `chain`. |
| 400 | `bad_request` | `invalid cursor (must be an int64)` | `cursor` is not a 64-bit integer. | Send `0` for the first page, then the previous page's `next_cursor`. |
| 403 | `forbidden` | `admin role required` | The caller is not an admin. | Call it with an admin account's session. |

#### Example request

```bash
curl "https://api-mig.proxima.tools/admin/system-events?cursor=0" \
  -H "Authorization: Bearer $PROXIMA_JWT"
```

#### Example response

```json
{
  "events": [
    {
      "id": "884100",
      "created_at": 1793577600,
      "event_type": "system.boot",
      "chain_id": null,
      "launch_ext_id": null,
      "payload": {
        "version": "1.42.0",
        "environment": "production"
      }
    }
  ],
  "next_cursor": null,
  "dropped_total": 0
}
```
