# Generate activity

> Run buy-and-sell loops on selected wallets so they build an on-chain trading history.

A generate-activity session makes each selected wallet perform repeated buy and sell loops over time. The API calls it fake volume: the routes live under `/wallets/{chain_id}/fake-volume/`. On Solana the tokens traded are picked from recent pump.fun mints.

One session runs at a time. Start it, follow it with [Retrieve the session](#retrieve-the-session) (the web app polls every 5 seconds while the Wallets page is open), stop it early if needed, then discard the finished session to clear its status.

Loop count and delay are capped by `aged_wallets.max_loops` and `aged_wallets.max_delay` from `/get-constants`. On deployments where [Wallet activity](/reference/wallet-activity/) is enabled, the Generate Activity button opens activity farms instead.

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

## Endpoints

- `GET /wallets/{chain_id}/fake-volume/status`: Retrieve the session
- `POST /wallets/{chain_id}/fake-volume/run`: Start a session
- `POST /wallets/{chain_id}/fake-volume/cancel`: Stop a session
- `POST /wallets/{chain_id}/fake-volume/discard`: Discard a session

## The Generate activity session object

The state of the account's session on a chain.

- `status` (enum): Session state. `None` when there is no session to show. Possible values: `Running`, `Completed`, `Failed`, `None`, `Cancelled`.
- `info` (object): Session settings and timing. Absent when `status` is `None`.
  - `started_at` (integer): Unix timestamp (seconds) at which the session started.
  - `ended_at` (integer): Unix timestamp (seconds) at which the session ended.
  - `loop_amount` (integer): Number of buy-and-sell loops requested.
  - `delay` (integer): Delay between loops, in milliseconds.
  - `min_sol_in` (integer): Minimum buy size per loop, in native base units.
  - `max_sol_in` (integer): Maximum buy size per loop, in native base units.
  - `wallets` (array<string>): Wallets in the session.
  - `status_reason` (string | null): Why the session failed, when it did.

```json
{
  "status": "Running",
  "info": {
    "started_at": 1793560000,
    "ended_at": 0,
    "loop_amount": 10,
    "delay": 30000,
    "min_sol_in": 20000000,
    "max_sol_in": 50000000,
    "wallets": [
      "C31EeqtSvpjYHFQxBoP9bBTpqtUWV2avNhjdaN1yem44",
      "ART7zvRihsxp6iuCegVRED44XZMov9u6fnFJHF7HqcN4"
    ],
    "status_reason": null
  }
}
```

### Retrieve the session

`GET /wallets/{chain_id}/fake-volume/status`

Returns the status and settings of the current or last session. (Bearer JWT)

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

#### Path parameters

- `chain_id` (enum, required): Chain of the session. The web app only offers chains whose `generate_activity` feature is enabled (currently `sol`). Possible values: `sol`, `eth`, `bsc`, `base`, `robinhood`, `monad`, `arc`, `xlayer`.

#### Returns 200 OK

Returns a [Generate activity session](#object-generate-activity-session) object.

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 400 | `bad_request` | `unknown chain_id: <chain_id>` | `chain_id` is not a chain the API serves. | Use a supported `chain_id`; `monad` is no longer accepted. |

#### Example request

```bash
curl "https://api-mig.proxima.tools/wallets/sol/fake-volume/status" \
  -H "Authorization: Bearer $PROXIMA_JWT"
```

#### Example response

```json
{
  "status": "Running",
  "info": {
    "started_at": 1793560000,
    "ended_at": 0,
    "loop_amount": 10,
    "delay": 30000,
    "min_sol_in": 20000000,
    "max_sol_in": 50000000,
    "wallets": [
      "C31EeqtSvpjYHFQxBoP9bBTpqtUWV2avNhjdaN1yem44",
      "ART7zvRihsxp6iuCegVRED44XZMov9u6fnFJHF7HqcN4"
    ],
    "status_reason": null
  }
}
```

### Start a session

`POST /wallets/{chain_id}/fake-volume/run`

Starts buy-and-sell loops on the given wallets. (Bearer JWT)

- Token: Upgraded session token, bound to a license.
- Read-only tokens: refused with `403 read_only_token`.
- Retry: Check before retrying. Before retrying, call [Retrieve the session](/reference/generate-activity/#retrieve-the-session) and check whether a session is `Running`. On `sol` a repeat while it runs returns 409; on EVM chains it starts a second session.

Each loop, every wallet buys a random amount between `min_sol_in` and `max_sol_in` and sells it back, then waits `delay` milliseconds.

> Spends the wallets' native balance on swaps and priority tips.

> The web app blocks the start when a wallet holds less than `max_sol_in` + 50,000 lamports of priority tip per loop (1,050,000 with `Axiom`) × `loop_amount` × `aged_wallets.min_balance_multiplier` / 10,000.

> On EVM chains the backend also requires `token_address`, reads `min_sol_in` and `max_sol_in` in whole native units and `delay` in seconds. The web app only starts sessions on `sol`.

#### Path parameters

- `chain_id` (enum, required): Chain of the session. The web app only offers chains whose `generate_activity` feature is enabled (currently `sol`). Possible values: `sol`, `eth`, `bsc`, `base`, `robinhood`, `monad`, `arc`, `xlayer`.

#### Body parameters

- `pubkeys` (array<string>, required): Wallets that trade. They must be wallets of the account.
- `min_sol_in` (integer, required): Minimum buy size per loop, in native base units. Greater than 0.
- `max_sol_in` (integer, required): Maximum buy size per loop, in native base units. At least `min_sol_in`.
- `loop_amount` (integer, required): Number of loops, from 1 to `aged_wallets.max_loops`.
- `delay` (integer, required): Delay between loops in milliseconds, up to `aged_wallets.max_delay`.
- `platform` (enum, required): Trading platform. With `Axiom`, the web app budgets an extra 1,000,000 lamports per loop in its balance check. Possible values: `None`, `Axiom`.

#### Returns 200 OK

- `ok` (boolean): Always `true` on success.
- `message` (string): Human-readable confirmation.

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 400 | `bad_request` | `unknown chain_id: <chain_id>` | `chain_id` is not a chain the API serves. | Use a supported `chain_id`; `monad` is no longer accepted. |
| 409 | `conflict` | `Task already running` | On `sol`, a session is already running. EVM chains do not check and start a second session. | Wait for it to finish, or stop it with [Stop a session](/reference/generate-activity/#stop-a-session). |
| 500 | `internal_error` | `sol amounts in must be greater than 0` | On `sol`, `min_sol_in` or `max_sol_in` is 0. Returned as a 500, not a 400. | Set both amounts above 0. |
| 500 | `internal_error` | `min_sol_in must be less than or equal to max_sol_in` | On `sol`, `min_sol_in` is above `max_sol_in`. Returned as a 500, not a 400. | Set `min_sol_in` no higher than `max_sol_in`. |
| 500 | `internal_error` | `max_sol_in exceeds the per-loop cap` | On `sol`, `max_sol_in` is above the per-loop cap of 1,000 SOL. Returned as a 500, not a 400. | Lower `max_sol_in`. |
| 500 | `internal_error` | `Too many loops requested` | On `sol`, `loop_amount` is above `aged_wallets.max_loops`. Returned as a 500, not a 400. | Lower `loop_amount` to `aged_wallets.max_loops` or less. |
| 500 | `internal_error` | `Too long delay requested` | On `sol`, `delay` is above `aged_wallets.max_delay`. Returned as a 500, not a 400. | Lower `delay` to `aged_wallets.max_delay` or less. |
| 500 | `internal_error` | `No pubkeys provided` | On `sol`, `pubkeys` is empty. Returned as a 500, not a 400. | Send at least one wallet in `pubkeys`. |
| 500 | `internal_error` | `Invalid pubkey format` | On `sol`, an address is not a valid Solana address. Returned as a 500, not a 400. | Check that every address is a valid base58 public key. |
| 500 | `internal_error` | `At least one wallet don't have enough funds to proceed` | On `sol`, a wallet holds less than the balance the session needs. Returned as a 500, not a 400. | Fund the wallets, or lower `max_sol_in` or `loop_amount`. |
| 500 | `internal_error` | `Wallet not found in license` | On `sol`, a wallet is not on the account. Returned as a 500, not a 400. | Use wallets from [List wallets](/reference/wallets/#list-wallets). |
| 500 | `internal_error` | `Wallet is watch-only and cannot sign` | On `sol`, a wallet is watch-only and cannot sign. Returned as a 500, not a 400. | Use wallets whose keys the account holds. |
| 422 | `upstream_failure` | `rpc api issue: <error>` | On `sol`, reading the wallets' balances from the RPC failed. | Retry after a short wait. |
| 400 | `bad_request` | `invalid body: missing field `token_address` at line 1 column <column>` | On EVM chains, the body has no `token_address`. | Add `token_address` with the token to trade. |
| 400 | `bad_request` | `no pubkeys provided` | On EVM chains, `pubkeys` is empty. | Send at least one wallet in `pubkeys`. |
| 400 | `bad_request` | `invalid token_address` | On EVM chains, `token_address` is not a valid address. | Send a valid `0x` token address. |
| 400 | `bad_request` | `wallet not found for license: <address>` | On EVM chains, a wallet is not on the account. | Use wallets from [List wallets](/reference/wallets/#list-wallets). |
| 400 | `bad_request` | `wallet is watched, cannot sign: <address>` | On EVM chains, a wallet is watch-only and cannot sign. | Use wallets whose keys the account holds. |

#### Example request

```bash
curl -X POST "https://api-mig.proxima.tools/wallets/sol/fake-volume/run" \
  -H "Authorization: Bearer $PROXIMA_JWT" \
  -H "Content-Type: application/json" \
  -d '{
  "pubkeys": [
    "C31EeqtSvpjYHFQxBoP9bBTpqtUWV2avNhjdaN1yem44",
    "ART7zvRihsxp6iuCegVRED44XZMov9u6fnFJHF7HqcN4"
  ],
  "min_sol_in": 20000000,
  "max_sol_in": 50000000,
  "loop_amount": 10,
  "delay": 30000,
  "platform": "None"
}'
```

#### Example response

```json
{
  "ok": true,
  "message": "Successfully started fake volume task"
}
```

### Stop a session

`POST /wallets/{chain_id}/fake-volume/cancel`

Stops the running session before its last loop. (Bearer JWT)

- Token: Upgraded session token, bound to a license.
- Read-only tokens: refused with `403 read_only_token`.
- Retry: Safe to retry. Stopping when no session runs still returns 200.

No request body. The web app only calls it when the session status is `Running`.

#### Path parameters

- `chain_id` (enum, required): Chain of the session. The web app only offers chains whose `generate_activity` feature is enabled (currently `sol`). Possible values: `sol`, `eth`, `bsc`, `base`, `robinhood`, `monad`, `arc`, `xlayer`.

#### Returns 200 OK

- `ok` (boolean): Always `true` on success.
- `message` (string): Human-readable confirmation.

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 400 | `bad_request` | `unknown chain_id: <chain_id>` | `chain_id` is not a chain the API serves. | Use a supported `chain_id`; `monad` is no longer accepted. |

#### Example request

```bash
curl -X POST "https://api-mig.proxima.tools/wallets/sol/fake-volume/cancel" \
  -H "Authorization: Bearer $PROXIMA_JWT"
```

#### Example response

```json
{
  "ok": true,
  "message": "Fake volume task successfully cancelled"
}
```

### Discard a session

`POST /wallets/{chain_id}/fake-volume/discard`

Clears the status of a finished session. (Bearer JWT)

- Token: Upgraded session token, bound to a license.
- Read-only tokens: refused with `403 read_only_token`.
- Retry: Safe to retry. Discarding a cleared status changes nothing.

No request body. The web app calls it when the user dismisses a completed, cancelled or failed session.

#### Path parameters

- `chain_id` (enum, required): Chain of the session. The web app only offers chains whose `generate_activity` feature is enabled (currently `sol`). Possible values: `sol`, `eth`, `bsc`, `base`, `robinhood`, `monad`, `arc`, `xlayer`.

#### Returns 200 OK

- `ok` (boolean): Always `true` on success.
- `message` (string): Human-readable confirmation.

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 400 | `bad_request` | `unknown chain_id: <chain_id>` | `chain_id` is not a chain the API serves. | Use a supported `chain_id`; `monad` is no longer accepted. |
| 409 | `conflict` | `Cannot discard running session` | On `sol`, the session is still running. EVM chains do not check. | Stop it with [Stop a session](/reference/generate-activity/#stop-a-session) first. |

#### Example request

```bash
curl -X POST "https://api-mig.proxima.tools/wallets/sol/fake-volume/discard" \
  -H "Authorization: Bearer $PROXIMA_JWT"
```

#### Example response

```json
{
  "ok": true,
  "message": "Successfully discarded fake volume session status"
}
```
