# Wallet activity

> Enroll wallets in activity farms that trade on their own across chains for a set duration.

Wallet activity enrolls wallets in farms. For the chosen duration, each wallet makes a random number of transactions per day on the chosen chains, buying and selling back in full, optionally toward a volume target and within a spend budget. Farms are run by the Hushxima marketplace service; Proxima validates the plan, checks that every wallet belongs to your account, and relays the call.

The flow is: read the [presets](#retrieve-activity-presets) for the supported chains and limits, [estimate](#estimate-an-activity-plan) a plan for per-wallet feasibility and cost, then [run](#run-an-activity-plan) it. [List farms](#list-farms) reports progress and [Stop farms](#stop-farms) ends them early.

In the web app this is behind the `walletActivityEnabled` flag (on by default on the dev deployment only), where the Generate Activity button opens it instead of [Generate activity](/reference/generate-activity/).

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

## Endpoints

- `GET /activity/presets`: Retrieve activity presets
- `POST /activity/estimate`: Estimate an activity plan
- `POST /activity/run`: Run an activity plan
- `POST /activity/stop`: Stop farms
- `GET /activity/farms`: List farms
- `GET /activity/farms/{address}/ops`: List farm operations

## The Farm object

A wallet enrolled in an activity farm, with its progress.

- `pubkey` (string): Wallet address.
- `network` (string): Network of the wallet.
- `chains` (array<string>): Chain IDs farmed.
- `state` (string): `running`, `stopped`, `finished`, or another state reported by the farming service.
- `stop_reason` (string | null): Why the farm stopped.
- `persona` (string | null): Trading persona.
- `timezone` (string | null): Timezone profile.
- `tier` (string | null): Tier.
- `tx_per_day` (integer | null): Transactions per day drawn for this wallet.
- `tx_count` (integer): Transactions made so far.
- `balance` (string): Current native balance, in base units.
- `start_balance` (string | null): Native balance at enrollment, in base units.
- `started_at` (string): ISO 8601 start time.
- `ends_at` (string): ISO 8601 scheduled end time.
- `stopped_at` (string | null): ISO 8601 stop time.
- `next_op_at` (string | null): ISO 8601 time of the next planned operation.
- `duration_secs` (integer): Planned duration in seconds.
- `continuous` (boolean): Whether the farm runs continuously.
- `volume_reached_at` (string | null): ISO 8601 time the volume target was reached.
- `budgets` (object): Spend limit per chain ID, in native base units. A chain left out has no limit.
- `ops_completed` (integer): Operations completed.
- `ops_failed` (integer): Operations failed.
- `ops_pending` (integer): Operations pending.
- `ops_skipped` (integer): Operations skipped.
- `chain_stats` (array<object>): Statistics per chain. Native amounts are base-unit decimal strings.
  - `chain` (string): Chain ID.
  - `volume` (string): Volume traded.
  - `volume_usd` (number): Volume traded, in USD.
  - `volume_target` (string | null): Target volume.
  - `volume_reached` (boolean): Whether the target is reached.
  - `buy_spent` (string): Native spent on buys.
  - `sell_received` (string): Native received from sells.
  - `fees` (string): Fees paid.
  - `fees_usd` (number): Fees paid, in USD.
  - `swap_loss` (string): Value lost to swaps.
  - `swap_loss_usd` (number): Value lost to swaps, in USD.
  - `native_usd` (number): USD price of the native token.
  - `recoverable` (object): Value still held that can be recovered.
    - `tokens_value` (string): Native value of tokens held.
    - `tokens_unpriced` (array<string>): Tokens held that could not be priced.
    - `rent` (string): Recoverable rent.
  - `txs_confirmed` (integer): Confirmed transactions.
  - `txs_failed` (integer): Failed transactions.
  - `txs_pending_effect` (integer): Transactions whose effect is not yet recorded.

```json
{
  "pubkey": "C31EeqtSvpjYHFQxBoP9bBTpqtUWV2avNhjdaN1yem44",
  "network": "svm",
  "chains": [
    "sol"
  ],
  "state": "running",
  "stop_reason": null,
  "persona": "volume",
  "timezone": "always_awake_burst",
  "tier": null,
  "tx_per_day": 9,
  "tx_count": 23,
  "balance": "1310000000",
  "start_balance": "1500000000",
  "started_at": "2026-10-30T09:12:00Z",
  "ends_at": "2026-11-06T09:12:00Z",
  "stopped_at": null,
  "next_op_at": "2026-11-02T14:41:00Z",
  "duration_secs": 604800,
  "continuous": false,
  "volume_reached_at": null,
  "budgets": {
    "sol": "1500000000"
  },
  "ops_completed": 23,
  "ops_failed": 1,
  "ops_pending": 1,
  "ops_skipped": 0,
  "chain_stats": [
    {
      "chain": "sol",
      "volume": "21400000000",
      "volume_usd": 3852,
      "volume_target": "50000000000",
      "volume_reached": false,
      "buy_spent": "10800000000",
      "sell_received": "10610000000",
      "fees": "9200000",
      "fees_usd": 1.66,
      "swap_loss": "180800000",
      "swap_loss_usd": 32.54,
      "native_usd": 180,
      "recoverable": {
        "tokens_value": "0",
        "tokens_unpriced": [],
        "rent": "2039280"
      },
      "txs_confirmed": 23,
      "txs_failed": 1,
      "txs_pending_effect": 0
    }
  ]
}
```

## The Farm operation object

One transaction made by a farm.

- `id` (string): Operation ID.
- `chain` (string): Chain ID.
- `op_type` (string): Operation type reported by the farming service.
- `status` (string): `confirmed`, `failed`, or another status reported by the farming service.
- `tx_hash` (string | null): Transaction hash or signature.
- `error` (string | null): Failure reason.
- `token_mint` (string | null): Token traded.
- `token_symbol` (string | null): Symbol of the token traded.
- `native_spent` (string | null): Native spent, in base units.
- `native_received` (string | null): Native received, in base units.
- `fee_native` (string | null): Fee paid, in native base units.
- `reverted` (boolean): Whether the transaction reverted.
- `created_at` (string): ISO 8601 creation time.
- `settled_at` (string | null): ISO 8601 settlement time.

```json
{
  "id": "4f9d94e0-65d2-4c21-8e36-963fe5159068",
  "chain": "sol",
  "op_type": "buy",
  "status": "confirmed",
  "tx_hash": "5K1g9bQMqoMvVUgSD92K9PUDSwmNuCpzQDU6DiEj9iBuYVDeph7qEmxrsodWFSguTfgUrZhhcZG7K3jMeSwHC2up",
  "error": null,
  "token_mint": "F5tEkCDmR87MF7i26oCT4Q4DBaufjAWTXioGFtiCFvob",
  "token_symbol": "CAT",
  "native_spent": "480000000",
  "native_received": null,
  "fee_native": "405000",
  "reverted": false,
  "created_at": "2026-11-02T13:58:10Z",
  "settled_at": "2026-11-02T13:58:12Z"
}
```

### Retrieve activity presets

`GET /activity/presets`

Returns the chains a farm can run on and the request limits. (Bearer JWT · beta)

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

The web app loads it when the Generate Activity modal opens and shows an error state if it fails.

#### Returns 200 OK

- `chains` (array<string>): Chain IDs a farm can run on.
- `limits` (object): Request limits.
  - `max_duration_days` (integer): Longest duration in days.
  - `max_duration_hours` (integer): Longest duration in hours.
  - `max_tx_per_day` (integer): Highest `tx_per_day_max`.
  - `max_wallets_per_request` (integer): Most wallets per run.

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 422 | `upstream_failure` | `hushxima api issue: <message>` | The farming service could not be reached, failed, or sent a body the API could not read. The body also carries `service: "hushxima"`. Refusals the service states itself come back with its own status (400, 404, 409, 422 or 429) and message. | Retry after a short wait; the failure is on the farming service's side. |

#### Example request

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

#### Example response

```json
{
  "chains": [
    "sol",
    "eth",
    "bsc",
    "base"
  ],
  "limits": {
    "max_duration_days": 30,
    "max_duration_hours": 720,
    "max_tx_per_day": 50,
    "max_wallets_per_request": 200
  }
}
```

### Estimate an activity plan

`POST /activity/estimate`

Returns per-wallet feasibility, planned volume and cost for a plan without enrolling anything. (Bearer JWT · beta)

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

Takes the same body as [Run an activity plan](#run-an-activity-plan). The web app calls it debounced while the plan is edited.

#### Body parameters

- `wallets` (array<string>, required): Wallets of the account to farm, SVM and EVM mixed. At most `limits.max_wallets_per_request`.
- `chains` (array<string>, required): Chain IDs to farm on, from the presets.
- `tier` (string, optional): Tier passed to the farming service. Not set by the web app.
- `tx_per_day_min` (integer, required): Minimum transactions per day per wallet, at least 1.
- `tx_per_day_max` (integer, required): Maximum transactions per day per wallet, at least `tx_per_day_min` and at most `limits.max_tx_per_day`.
- `duration_hours` (integer, optional): Farm duration in hours. Send this or `duration_days`.
- `duration_days` (integer, optional): Farm duration in days. Send this or `duration_hours`.
- `volume_target` (object, optional): Target volume per chain ID, in native base units as positive decimal strings. Every key must be in `chains`.
- `budgets` (object, optional): Spend limits per chain ID, in native base units. A wallet takes the budget of its home chain only: `sol` for a Solana wallet, the first EVM chain in `chains` for an EVM wallet. A budget on another EVM chain is accepted but not applied. Every key must be in `chains`.
  - `{chain_id}` (object, optional): Spend limits on one chain, keyed by chain ID.
    - `min_native` (string, optional): Minimum, in native base units.
    - `max_native` (string, optional): Maximum, in native base units. At least `min_native`.
- `budget_compound` (boolean, optional): Passed to the farming service. Not set by the web app.
- `token_mints` (array<string>, optional): Token addresses passed to the farming service. Not set by the web app.
- `token_inherit_default` (boolean, optional): Passed to the farming service. Not set by the web app.

#### Returns 200 OK

- `feasible` (boolean): Whether the whole plan can run.
- `continuous` (boolean): Whether the farm runs continuously.
- `duration_secs` (integer): Planned duration in seconds.
- `wallets` (array<object>): Per-wallet estimate.
  - `address` (string): Wallet address.
  - `feasible` (boolean): Whether this wallet can run the plan.
  - `reasons` (array<object>): Why the wallet is not feasible.
    - `code` (string): Machine-readable reason.
    - `message` (string): Human-readable reason.
  - `chains` (array<object>): Estimate per chain. Native amounts are base-unit decimal strings.
    - `chain` (string): Chain ID.
    - `balance` (string): Current native balance.
    - `spendable` (string): Balance the farm may use.
    - `buy_size` (string): Planned size of each buy.
    - `planned_txs` (integer): Planned transactions.
    - `planned_buys` (integer): Planned buys.
    - `volume` (string): Planned volume.
    - `volume_usd` (number): Planned volume, in USD.
    - `fees` (string): Expected fees.
    - `swap_loss` (string): Expected swap loss.
    - `cost` (string): Expected total cost.
    - `cost_usd` (number): Expected total cost, in USD.

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 400 | `bad_request` | `invalid body: <path>: <cause>` | The body is not valid JSON, or a field is missing or has the wrong type. | Fix the field named in `message` and send the request again. |
| 400 | `bad_request` | `chains is empty` | `chains` is empty. | Send at least one chain. |
| 400 | `bad_request` | `unknown chain: <chain>` | A key of `chains`, `budgets` or `volume_target` is not a chain the API serves. | Use chain IDs listed by [Retrieve activity presets](/reference/wallet-activity/#retrieve-activity-presets); `monad` is no longer accepted. |
| 400 | `unsupported_chain` | `this endpoint is not supported for this chain` | A key of `chains`, `budgets` or `volume_target` is `xlayer`, which cannot be farmed. The body adds `chain`. | Farm only chains listed by [Retrieve activity presets](/reference/wallet-activity/#retrieve-activity-presets). |
| 400 | `bad_request` | `tx_per_day_min must be between 1 and tx_per_day_max` | `tx_per_day_min` is 0 or above `tx_per_day_max`. | Keep `tx_per_day_min` between 1 and `tx_per_day_max`. |
| 400 | `bad_request` | `duration_hours or duration_days is required` | Neither `duration_hours` nor `duration_days` was sent. | Send `duration_hours` or `duration_days`. |
| 400 | `bad_request` | `duration must be at least 1` | `duration_hours` or `duration_days` is 0. | Send a duration of at least 1. |
| 400 | `bad_request` | `budgets names <chain>, which is not farmed` | A `budgets` key is not in `chains`. | Key `budgets` only by chains listed in `chains`. |
| 400 | `bad_request` | `budgets.<chain>: min_native must not exceed max_native` | A budget's `min_native` is above its `max_native`. | Set `min_native` no higher than `max_native`. |
| 400 | `bad_request` | `volume_target names <chain>, which is not farmed` | A `volume_target` key is not in `chains`. | Key `volume_target` only by chains listed in `chains`. |
| 400 | `bad_request` | `volume_target.<chain> must be a decimal string` | A `volume_target` value is neither a string nor a number. | Send each target as a decimal string of base units. |
| 400 | `bad_request` | `volume_target.<chain> must be a positive integer in base units` | A `volume_target` value is 0 or not a whole number of base units. | Send each target as a positive whole number of base units. |
| 400 | `bad_request` | `wallets is empty` | `wallets` is empty or holds only blank strings. | Send at least one wallet. |
| 400 | `bad_request` | `at most 200 wallets per request` | More than 200 distinct wallets were sent. Duplicates and blank entries are dropped before counting. | Send at most 200 wallets per call. |
| 404 | `not_found` | `wallet <address> is not on this license` | A wallet is not on the account. The whole request is refused. | Use wallets from [List wallets](/reference/wallets/#list-wallets). |
| 422 | `upstream_failure` | `hushxima api issue: <message>` | The farming service could not be reached, failed, or sent a body the API could not read. The body also carries `service: "hushxima"`. Refusals the service states itself come back with its own status (400, 404, 409, 422 or 429) and message. | Retry after a short wait; the failure is on the farming service's side. |

#### Example request

```bash
curl -X POST "https://api-mig.proxima.tools/activity/estimate" \
  -H "Authorization: Bearer $PROXIMA_JWT" \
  -H "Content-Type: application/json" \
  -d '{
  "wallets": [
    "C31EeqtSvpjYHFQxBoP9bBTpqtUWV2avNhjdaN1yem44",
    "0xa5fbbe950f155ca0ed4a15d1001c98ed78c19cf3"
  ],
  "chains": [
    "sol",
    "base"
  ],
  "tx_per_day_min": 4,
  "tx_per_day_max": 12,
  "duration_days": 7,
  "volume_target": {
    "sol": "50000000000",
    "base": "2000000000000000000"
  },
  "budgets": {
    "sol": {
      "max_native": "1500000000"
    }
  }
}'
```

#### Example response

```json
{
  "feasible": true,
  "continuous": false,
  "duration_secs": 604800,
  "wallets": [
    {
      "address": "C31EeqtSvpjYHFQxBoP9bBTpqtUWV2avNhjdaN1yem44",
      "feasible": true,
      "reasons": [],
      "chains": [
        {
          "chain": "sol",
          "balance": "1500000000",
          "spendable": "1450000000",
          "buy_size": "480000000",
          "planned_txs": 56,
          "planned_buys": 28,
          "volume": "26880000000",
          "volume_usd": 4838.4,
          "fees": "22680000",
          "swap_loss": "241920000",
          "cost": "264600000",
          "cost_usd": 47.63
        }
      ]
    }
  ]
}
```

### Run an activity plan

`POST /activity/run`

Enrolls wallets in a farm according to a plan. (Bearer JWT · beta)

- Token: Upgraded session token, bound to a license.
- Read-only tokens: refused with `403 read_only_token`.
- Retry: Check before retrying. Before retrying, call [List farms](/reference/wallet-activity/#list-farms) and check whether the wallets already have a running farm.

Wallets that cannot be enrolled are returned in `skipped`. The web app refreshes the farm list after the call.

> Each wallet's private key is sent to the Hushxima farming service, which then trades with the wallet's funds until the farm ends or is stopped.

#### Body parameters

- `wallets` (array<string>, required): Wallets of the account to farm, SVM and EVM mixed. At most `limits.max_wallets_per_request`.
- `chains` (array<string>, required): Chain IDs to farm on, from the presets.
- `tier` (string, optional): Tier passed to the farming service. Not set by the web app.
- `tx_per_day_min` (integer, required): Minimum transactions per day per wallet, at least 1.
- `tx_per_day_max` (integer, required): Maximum transactions per day per wallet, at least `tx_per_day_min` and at most `limits.max_tx_per_day`.
- `duration_hours` (integer, optional): Farm duration in hours. Send this or `duration_days`.
- `duration_days` (integer, optional): Farm duration in days. Send this or `duration_hours`.
- `volume_target` (object, optional): Target volume per chain ID, in native base units as positive decimal strings. Every key must be in `chains`.
- `budgets` (object, optional): Spend limits per chain ID, in native base units. A wallet takes the budget of its home chain only: `sol` for a Solana wallet, the first EVM chain in `chains` for an EVM wallet. A budget on another EVM chain is accepted but not applied. Every key must be in `chains`.
  - `{chain_id}` (object, optional): Spend limits on one chain, keyed by chain ID.
    - `min_native` (string, optional): Minimum, in native base units.
    - `max_native` (string, optional): Maximum, in native base units. At least `min_native`.
- `budget_compound` (boolean, optional): Passed to the farming service. Not set by the web app.
- `token_mints` (array<string>, optional): Token addresses passed to the farming service. Not set by the web app.
- `token_inherit_default` (boolean, optional): Passed to the farming service. Not set by the web app.

#### Returns 200 OK

- `enrolled` (array<object>): Wallets enrolled.
  - `pubkey` (string): Wallet address.
  - `chains` (array<string>): Chain IDs farmed.
  - `ends_at` (string): ISO 8601 scheduled end time.
  - `tx_per_day` (integer): Transactions per day drawn for this wallet.
  - `budgets` (object): Spend limit per chain ID, in native base units. A chain left out has no limit.
  - `purchased` (boolean): Purchase flag reported by the farming service.
  - `reenrolled` (boolean): Whether the wallet was enrolled again rather than for the first time.
- `skipped` (array<object>): Wallets not enrolled.
  - `reference` (string): Wallet address or reference skipped.
  - `reason` (string): Why it was skipped.

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 400 | `bad_request` | `invalid body: <path>: <cause>` | The body is not valid JSON, or a field is missing or has the wrong type. | Fix the field named in `message` and send the request again. |
| 400 | `bad_request` | `chains is empty` | `chains` is empty. | Send at least one chain. |
| 400 | `bad_request` | `unknown chain: <chain>` | A key of `chains`, `budgets` or `volume_target` is not a chain the API serves. | Use chain IDs listed by [Retrieve activity presets](/reference/wallet-activity/#retrieve-activity-presets); `monad` is no longer accepted. |
| 400 | `unsupported_chain` | `this endpoint is not supported for this chain` | A key of `chains`, `budgets` or `volume_target` is `xlayer`, which cannot be farmed. The body adds `chain`. | Farm only chains listed by [Retrieve activity presets](/reference/wallet-activity/#retrieve-activity-presets). |
| 400 | `bad_request` | `tx_per_day_min must be between 1 and tx_per_day_max` | `tx_per_day_min` is 0 or above `tx_per_day_max`. | Keep `tx_per_day_min` between 1 and `tx_per_day_max`. |
| 400 | `bad_request` | `duration_hours or duration_days is required` | Neither `duration_hours` nor `duration_days` was sent. | Send `duration_hours` or `duration_days`. |
| 400 | `bad_request` | `duration must be at least 1` | `duration_hours` or `duration_days` is 0. | Send a duration of at least 1. |
| 400 | `bad_request` | `budgets names <chain>, which is not farmed` | A `budgets` key is not in `chains`. | Key `budgets` only by chains listed in `chains`. |
| 400 | `bad_request` | `budgets.<chain>: min_native must not exceed max_native` | A budget's `min_native` is above its `max_native`. | Set `min_native` no higher than `max_native`. |
| 400 | `bad_request` | `volume_target names <chain>, which is not farmed` | A `volume_target` key is not in `chains`. | Key `volume_target` only by chains listed in `chains`. |
| 400 | `bad_request` | `volume_target.<chain> must be a decimal string` | A `volume_target` value is neither a string nor a number. | Send each target as a decimal string of base units. |
| 400 | `bad_request` | `volume_target.<chain> must be a positive integer in base units` | A `volume_target` value is 0 or not a whole number of base units. | Send each target as a positive whole number of base units. |
| 400 | `bad_request` | `wallets is empty` | `wallets` is empty or holds only blank strings. | Send at least one wallet. |
| 400 | `bad_request` | `at most 200 wallets per request` | More than 200 distinct wallets were sent. Duplicates and blank entries are dropped before counting. | Send at most 200 wallets per call. |
| 404 | `not_found` | `wallet <address> is not on this license` | A wallet is not on the account. The whole request is refused. | Use wallets from [List wallets](/reference/wallets/#list-wallets). |
| 422 | `unprocessable` | `wallet <address> is watch-only and cannot be farmed` | A wallet is watch-only, so there is no key to hand to the farming service. The whole request is refused. | Remove watch-only wallets from `wallets`. |
| 422 | `upstream_failure` | `hushxima api issue: <message>` | The farming service could not be reached, failed, or sent a body the API could not read. The body also carries `service: "hushxima"`. Refusals the service states itself come back with its own status (400, 404, 409, 422 or 429) and message. | Retry after a short wait; the failure is on the farming service's side. |

#### Example request

```bash
curl -X POST "https://api-mig.proxima.tools/activity/run" \
  -H "Authorization: Bearer $PROXIMA_JWT" \
  -H "Content-Type: application/json" \
  -d '{
  "wallets": [
    "C31EeqtSvpjYHFQxBoP9bBTpqtUWV2avNhjdaN1yem44",
    "0xa5fbbe950f155ca0ed4a15d1001c98ed78c19cf3"
  ],
  "chains": [
    "sol",
    "base"
  ],
  "tx_per_day_min": 4,
  "tx_per_day_max": 12,
  "duration_days": 7,
  "volume_target": {
    "sol": "50000000000",
    "base": "2000000000000000000"
  },
  "budgets": {
    "sol": {
      "max_native": "1500000000"
    }
  }
}'
```

#### Example response

```json
{
  "enrolled": [
    {
      "pubkey": "C31EeqtSvpjYHFQxBoP9bBTpqtUWV2avNhjdaN1yem44",
      "chains": [
        "sol"
      ],
      "ends_at": "2026-11-09T14:00:00Z",
      "tx_per_day": 9,
      "budgets": {
        "sol": "1500000000"
      },
      "purchased": true,
      "reenrolled": false
    },
    {
      "pubkey": "0xa5fbbe950f155ca0ed4a15d1001c98ed78c19cf3",
      "chains": [
        "base"
      ],
      "ends_at": "2026-11-09T14:00:00Z",
      "tx_per_day": 6,
      "purchased": true,
      "reenrolled": false
    }
  ],
  "skipped": []
}
```

### Stop farms

`POST /activity/stop`

Stops the farms of the given wallets. (Bearer JWT · beta)

- Token: Upgraded session token, bound to a license.
- Read-only tokens: refused with `403 read_only_token`.
- Retry: Safe to retry. Stopping a farm that is already stopped changes nothing.

#### Body parameters

- `wallets` (array<string>, required): Wallets of the account whose farm to stop. At most 200.
- `forget` (boolean, optional, default "false"): Passed to the farming service with the stop. The web app always sends `false`.

#### Returns 200 OK

- `stopped` (array<string>): Wallets stopped.
- `skipped` (array<object>): Wallets not stopped.
  - `reference` (string): Wallet address or reference skipped.
  - `reason` (string): Why it was skipped.

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 400 | `bad_request` | `invalid body: <path>: <cause>` | The body is not valid JSON, or a field is missing or has the wrong type. | Fix the field named in `message` and send the request again. |
| 400 | `bad_request` | `wallets is empty` | `wallets` is empty or holds only blank strings. | Send at least one wallet. |
| 400 | `bad_request` | `at most 200 wallets per request` | More than 200 distinct wallets were sent. Duplicates and blank entries are dropped before counting. | Send at most 200 wallets per call. |
| 404 | `not_found` | `wallet <address> is not on this license` | A wallet is not on the account. The whole request is refused. | Use wallets from [List wallets](/reference/wallets/#list-wallets). |
| 422 | `upstream_failure` | `hushxima api issue: <message>` | The farming service could not be reached, failed, or sent a body the API could not read. The body also carries `service: "hushxima"`. Refusals the service states itself come back with its own status (400, 404, 409, 422 or 429) and message. | Retry after a short wait; the failure is on the farming service's side. |

#### Example request

```bash
curl -X POST "https://api-mig.proxima.tools/activity/stop" \
  -H "Authorization: Bearer $PROXIMA_JWT" \
  -H "Content-Type: application/json" \
  -d '{
  "wallets": [
    "C31EeqtSvpjYHFQxBoP9bBTpqtUWV2avNhjdaN1yem44"
  ],
  "forget": false
}'
```

#### Example response

```json
{
  "stopped": [
    "C31EeqtSvpjYHFQxBoP9bBTpqtUWV2avNhjdaN1yem44"
  ],
  "skipped": []
}
```

### List farms

`GET /activity/farms`

Returns the account's farms with their progress and per-chain stats. (Bearer JWT · beta)

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

The web app polls it every 15 seconds in pages of 50, re-reading every loaded page on each poll.

#### Query parameters

- `include_stopped` (boolean, optional, default "false"): Also return stopped and finished farms.
- `limit` (integer, optional, default "200"): Page size, from 1 to 200; values outside are clamped. The web app sends 50.
- `offset` (integer, optional, default "0"): Number of farms to skip.

#### Returns 200 OK

Returns an array of [Farm](#object-farm) objects.

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 422 | `upstream_failure` | `hushxima api issue: <message>` | The farming service could not be reached, failed, or sent a body the API could not read. The body also carries `service: "hushxima"`. Refusals the service states itself come back with its own status (400, 404, 409, 422 or 429) and message. | Retry after a short wait; the failure is on the farming service's side. |

#### Example request

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

#### Example response

```json
[
  {
    "pubkey": "C31EeqtSvpjYHFQxBoP9bBTpqtUWV2avNhjdaN1yem44",
    "network": "svm",
    "chains": [
      "sol"
    ],
    "state": "running",
    "stop_reason": null,
    "persona": "volume",
    "timezone": "always_awake_burst",
    "tier": null,
    "tx_per_day": 9,
    "tx_count": 23,
    "balance": "1310000000",
    "start_balance": "1500000000",
    "started_at": "2026-10-30T09:12:00Z",
    "ends_at": "2026-11-06T09:12:00Z",
    "stopped_at": null,
    "next_op_at": "2026-11-02T14:41:00Z",
    "duration_secs": 604800,
    "continuous": false,
    "volume_reached_at": null,
    "budgets": {
      "sol": "1500000000"
    },
    "ops_completed": 23,
    "ops_failed": 1,
    "ops_pending": 1,
    "ops_skipped": 0,
    "chain_stats": [
      {
        "chain": "sol",
        "volume": "21400000000",
        "volume_usd": 3852,
        "volume_target": "50000000000",
        "volume_reached": false,
        "buy_spent": "10800000000",
        "sell_received": "10610000000",
        "fees": "9200000",
        "fees_usd": 1.66,
        "swap_loss": "180800000",
        "swap_loss_usd": 32.54,
        "native_usd": 180,
        "recoverable": {
          "tokens_value": "0",
          "tokens_unpriced": [],
          "rent": "2039280"
        },
        "txs_confirmed": 23,
        "txs_failed": 1,
        "txs_pending_effect": 0
      }
    ]
  }
]
```

### List farm operations

`GET /activity/farms/{address}/ops`

Returns the transactions made by one wallet's farm. (Bearer JWT · beta)

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

> Not called by the current web app.

#### Path parameters

- `address` (string, required): Wallet address. Must be a wallet of the account.

#### Query parameters

- `limit` (integer, optional, default "50"): Page size, from 1 to 200; values outside are clamped.
- `offset` (integer, optional, default "0"): Number of operations to skip.

#### Returns 200 OK

Returns an array of [Farm operation](#object-farm-operation) objects.

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 404 | `not_found` | `wallet <address> is not on this license` | The wallet is not on the account. | Use wallets from [List wallets](/reference/wallets/#list-wallets). |
| 422 | `upstream_failure` | `hushxima api issue: <message>` | The farming service could not be reached, failed, or sent a body the API could not read. The body also carries `service: "hushxima"`. Refusals the service states itself come back with its own status (400, 404, 409, 422 or 429) and message. | Retry after a short wait; the failure is on the farming service's side. |

#### Example request

```bash
curl "https://api-mig.proxima.tools/activity/farms/C31EeqtSvpjYHFQxBoP9bBTpqtUWV2avNhjdaN1yem44/ops" \
  -H "Authorization: Bearer $PROXIMA_JWT"
```

#### Example response

```json
[
  {
    "id": "4f9d94e0-65d2-4c21-8e36-963fe5159068",
    "chain": "sol",
    "op_type": "buy",
    "status": "confirmed",
    "tx_hash": "5K1g9bQMqoMvVUgSD92K9PUDSwmNuCpzQDU6DiEj9iBuYVDeph7qEmxrsodWFSguTfgUrZhhcZG7K3jMeSwHC2up",
    "error": null,
    "token_mint": "F5tEkCDmR87MF7i26oCT4Q4DBaufjAWTXioGFtiCFvob",
    "token_symbol": "CAT",
    "native_spent": "480000000",
    "native_received": null,
    "fee_native": "405000",
    "reverted": false,
    "created_at": "2026-11-02T13:58:10Z",
    "settled_at": "2026-11-02T13:58:12Z"
  }
]
```
