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 for the supported chains and limits, estimate a plan for per-wallet feasibility and cost, then run it. List farms reports progress and 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.
The Farm object
A wallet enrolled in an activity farm, with its progress.
Attributes
-
pubkeystringWallet address. -
networkstringNetwork of the wallet. -
chainsarray<string>Chain IDs farmed. -
statestringrunning,stopped,finished, or another state reported by the farming service. -
stop_reasonstring | nullWhy the farm stopped. -
personastring | nullTrading persona. -
timezonestring | nullTimezone profile. -
tierstring | nullTier. -
tx_per_dayinteger | nullTransactions per day drawn for this wallet. -
tx_countintegerTransactions made so far. -
balancestringCurrent native balance, in base units. -
start_balancestring | nullNative balance at enrollment, in base units. -
started_atstringISO 8601 start time. -
ends_atstringISO 8601 scheduled end time. -
stopped_atstring | nullISO 8601 stop time. -
next_op_atstring | nullISO 8601 time of the next planned operation. -
duration_secsintegerPlanned duration in seconds. -
continuousbooleanWhether the farm runs continuously. -
volume_reached_atstring | nullISO 8601 time the volume target was reached. -
budgetsobjectSpend limit per chain ID, in native base units. A chain left out has no limit. -
ops_completedintegerOperations completed. -
ops_failedintegerOperations failed. -
ops_pendingintegerOperations pending. -
ops_skippedintegerOperations skipped. -
chain_statsarray<object>Statistics per chain. Native amounts are base-unit decimal strings.Child attributes 19
-
chainstringChain ID. -
volumestringVolume traded. -
volume_usdnumberVolume traded, in USD. -
volume_targetstring | nullTarget volume. -
volume_reachedbooleanWhether the target is reached. -
buy_spentstringNative spent on buys. -
sell_receivedstringNative received from sells. -
feesstringFees paid. -
fees_usdnumberFees paid, in USD. -
swap_lossstringValue lost to swaps. -
swap_loss_usdnumberValue lost to swaps, in USD. -
native_usdnumberUSD price of the native token. -
recoverableobjectValue still held that can be recovered.Child attributes 3
-
tokens_valuestringNative value of tokens held. -
tokens_unpricedarray<string>Tokens held that could not be priced. -
rentstringRecoverable rent.
-
-
txs_confirmedintegerConfirmed transactions. -
txs_failedintegerFailed transactions. -
txs_pending_effectintegerTransactions whose effect is not yet recorded.
-
The Farm operation object
One transaction made by a farm.
Attributes
-
idstringOperation ID. -
chainstringChain ID. -
op_typestringOperation type reported by the farming service. -
statusstringconfirmed,failed, or another status reported by the farming service. -
tx_hashstring | nullTransaction hash or signature. -
errorstring | nullFailure reason. -
token_mintstring | nullToken traded. -
token_symbolstring | nullSymbol of the token traded. -
native_spentstring | nullNative spent, in base units. -
native_receivedstring | nullNative received, in base units. -
fee_nativestring | nullFee paid, in native base units. -
revertedbooleanWhether the transaction reverted. -
created_atstringISO 8601 creation time. -
settled_atstring | nullISO 8601 settlement time.
Retrieve activity presets
/activity/presets Returns the chains a farm can run on and the request limits.
- 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.
Parameters
No parameters.
Returns 200 OK · application/json
-
chainsarray<string>Chain IDs a farm can run on. -
limitsobjectRequest limits.Child attributes 4
-
max_duration_daysintegerLongest duration in days. -
max_duration_hoursintegerLongest duration in hours. -
max_tx_per_dayintegerHighesttx_per_day_max. -
max_wallets_per_requestintegerMost wallets per run.
-
Errors
| Status | Code | When and what to do |
|---|---|---|
| 422 | upstream_failure | 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. |
Also the common errors: 401 for a missing or expired session or a base token (license_required) and 429 when rate limited.
Web client proxima.walletActivity.getPresets() src/lib/proxima/endpoints/wallet-activity.ts
Estimate an activity plan
/activity/estimate Returns per-wallet feasibility, planned volume and cost for a plan without enrolling anything.
- 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. The web app calls it debounced while the plan is edited.
Body parameters application/json
-
walletsarray<string> RequiredWallets of the account to farm, SVM and EVM mixed. At mostlimits.max_wallets_per_request. -
chainsarray<string> RequiredChain IDs to farm on, from the presets. -
tierstring OptionalTier passed to the farming service. Not set by the web app. -
tx_per_day_mininteger RequiredMinimum transactions per day per wallet, at least 1. -
tx_per_day_maxinteger RequiredMaximum transactions per day per wallet, at leasttx_per_day_minand at mostlimits.max_tx_per_day. -
duration_hoursinteger OptionalFarm duration in hours. Send this orduration_days. -
duration_daysinteger OptionalFarm duration in days. Send this orduration_hours. -
volume_targetobject OptionalTarget volume per chain ID, in native base units as positive decimal strings. Every key must be inchains. -
budgetsobject OptionalSpend limits per chain ID, in native base units. A wallet takes the budget of its home chain only:solfor a Solana wallet, the first EVM chain inchainsfor an EVM wallet. A budget on another EVM chain is accepted but not applied. Every key must be inchains.Child attributes 3
-
{chain_id}object OptionalSpend limits on one chain, keyed by chain ID.Child attributes 2
-
min_nativestring OptionalMinimum, in native base units. -
max_nativestring OptionalMaximum, in native base units. At leastmin_native.
-
-
-
budget_compoundboolean OptionalPassed to the farming service. Not set by the web app. -
token_mintsarray<string> OptionalToken addresses passed to the farming service. Not set by the web app. -
token_inherit_defaultboolean OptionalPassed to the farming service. Not set by the web app.
Returns 200 OK · application/json
-
feasiblebooleanWhether the whole plan can run. -
continuousbooleanWhether the farm runs continuously. -
duration_secsintegerPlanned duration in seconds. -
walletsarray<object>Per-wallet estimate.Child attributes 18
-
addressstringWallet address. -
feasiblebooleanWhether this wallet can run the plan. -
reasonsarray<object>Why the wallet is not feasible.Child attributes 2
-
codestringMachine-readable reason. -
messagestringHuman-readable reason.
-
-
chainsarray<object>Estimate per chain. Native amounts are base-unit decimal strings.Child attributes 12
-
chainstringChain ID. -
balancestringCurrent native balance. -
spendablestringBalance the farm may use. -
buy_sizestringPlanned size of each buy. -
planned_txsintegerPlanned transactions. -
planned_buysintegerPlanned buys. -
volumestringPlanned volume. -
volume_usdnumberPlanned volume, in USD. -
feesstringExpected fees. -
swap_lossstringExpected swap loss. -
coststringExpected total cost. -
cost_usdnumberExpected total cost, in USD.
-
-
Errors
| Status | Code | When and what to do |
|---|---|---|
| 400 | bad_request | 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. Send at least one chain. |
| 400 | bad_request | A key of chains, budgets or volume_target is not a chain the API serves. Use chain IDs listed by Retrieve activity presets; monad is no longer accepted. |
| 400 | unsupported_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. |
| 400 | bad_request | 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 | Neither duration_hours nor duration_days was sent. Send duration_hours or duration_days. |
| 400 | bad_request | duration_hours or duration_days is 0. Send a duration of at least 1. |
| 400 | bad_request | A budgets key is not in chains. Key budgets only by chains listed in chains. |
| 400 | bad_request | A budget's min_native is above its max_native. Set min_native no higher than max_native. |
| 400 | bad_request | A volume_target key is not in chains. Key volume_target only by chains listed in chains. |
| 400 | bad_request | A volume_target value is neither a string nor a number. Send each target as a decimal string of base units. |
| 400 | bad_request | 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 or holds only blank strings. Send at least one wallet. |
| 400 | bad_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 | A wallet is not on the account. The whole request is refused. Use wallets from List wallets. |
| 422 | upstream_failure | 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. |
Also the common errors: 401 for a missing or expired session or a base token (license_required), 403 read_only_token and 429 when rate limited.
Web client proxima.walletActivity.estimate(plan) src/lib/proxima/endpoints/wallet-activity.ts
Run an activity plan
/activity/run Enrolls wallets in a farm according to a plan.
- 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 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.
Body parameters application/json
-
walletsarray<string> RequiredWallets of the account to farm, SVM and EVM mixed. At mostlimits.max_wallets_per_request. -
chainsarray<string> RequiredChain IDs to farm on, from the presets. -
tierstring OptionalTier passed to the farming service. Not set by the web app. -
tx_per_day_mininteger RequiredMinimum transactions per day per wallet, at least 1. -
tx_per_day_maxinteger RequiredMaximum transactions per day per wallet, at leasttx_per_day_minand at mostlimits.max_tx_per_day. -
duration_hoursinteger OptionalFarm duration in hours. Send this orduration_days. -
duration_daysinteger OptionalFarm duration in days. Send this orduration_hours. -
volume_targetobject OptionalTarget volume per chain ID, in native base units as positive decimal strings. Every key must be inchains. -
budgetsobject OptionalSpend limits per chain ID, in native base units. A wallet takes the budget of its home chain only:solfor a Solana wallet, the first EVM chain inchainsfor an EVM wallet. A budget on another EVM chain is accepted but not applied. Every key must be inchains.Child attributes 3
-
{chain_id}object OptionalSpend limits on one chain, keyed by chain ID.Child attributes 2
-
min_nativestring OptionalMinimum, in native base units. -
max_nativestring OptionalMaximum, in native base units. At leastmin_native.
-
-
-
budget_compoundboolean OptionalPassed to the farming service. Not set by the web app. -
token_mintsarray<string> OptionalToken addresses passed to the farming service. Not set by the web app. -
token_inherit_defaultboolean OptionalPassed to the farming service. Not set by the web app.
Returns 200 OK · application/json
-
enrolledarray<object>Wallets enrolled.Child attributes 7
-
pubkeystringWallet address. -
chainsarray<string>Chain IDs farmed. -
ends_atstringISO 8601 scheduled end time. -
tx_per_dayintegerTransactions per day drawn for this wallet. -
budgetsobjectSpend limit per chain ID, in native base units. A chain left out has no limit. -
purchasedbooleanPurchase flag reported by the farming service. -
reenrolledbooleanWhether the wallet was enrolled again rather than for the first time.
-
-
skippedarray<object>Wallets not enrolled.Child attributes 2
-
referencestringWallet address or reference skipped. -
reasonstringWhy it was skipped.
-
Errors
| Status | Code | When and what to do |
|---|---|---|
| 400 | bad_request | 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. Send at least one chain. |
| 400 | bad_request | A key of chains, budgets or volume_target is not a chain the API serves. Use chain IDs listed by Retrieve activity presets; monad is no longer accepted. |
| 400 | unsupported_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. |
| 400 | bad_request | 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 | Neither duration_hours nor duration_days was sent. Send duration_hours or duration_days. |
| 400 | bad_request | duration_hours or duration_days is 0. Send a duration of at least 1. |
| 400 | bad_request | A budgets key is not in chains. Key budgets only by chains listed in chains. |
| 400 | bad_request | A budget's min_native is above its max_native. Set min_native no higher than max_native. |
| 400 | bad_request | A volume_target key is not in chains. Key volume_target only by chains listed in chains. |
| 400 | bad_request | A volume_target value is neither a string nor a number. Send each target as a decimal string of base units. |
| 400 | bad_request | 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 or holds only blank strings. Send at least one wallet. |
| 400 | bad_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 | A wallet is not on the account. The whole request is refused. Use wallets from List wallets. |
| 422 | unprocessable | 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 | 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. |
Also the common errors: 401 for a missing or expired session or a base token (license_required), 403 read_only_token and 429 when rate limited.
Web client proxima.walletActivity.run(plan) src/lib/proxima/endpoints/wallet-activity.ts
Stop farms
/activity/stop Stops the farms of the given wallets.
- 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 application/json
-
walletsarray<string> RequiredWallets of the account whose farm to stop. At most 200. -
forgetboolean OptionalPassed to the farming service with the stop. The web app always sendsfalse.
Returns 200 OK · application/json
-
stoppedarray<string>Wallets stopped. -
skippedarray<object>Wallets not stopped.Child attributes 2
-
referencestringWallet address or reference skipped. -
reasonstringWhy it was skipped.
-
Errors
| Status | Code | When and what to do |
|---|---|---|
| 400 | bad_request | 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 or holds only blank strings. Send at least one wallet. |
| 400 | bad_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 | A wallet is not on the account. The whole request is refused. Use wallets from List wallets. |
| 422 | upstream_failure | 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. |
Also the common errors: 401 for a missing or expired session or a base token (license_required), 403 read_only_token and 429 when rate limited.
Web client proxima.walletActivity.stop(wallets, forget?) src/lib/proxima/endpoints/wallet-activity.ts
List farms
/activity/farms Returns the account's farms with their progress and per-chain stats.
- 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_stoppedboolean OptionalAlso return stopped and finished farms. -
limitinteger OptionalPage size, from 1 to 200; values outside are clamped. The web app sends 50. -
offsetinteger OptionalNumber of farms to skip.
Returns 200 OK · application/json
Returns an array of Farm objects.
Errors
| Status | Code | When and what to do |
|---|---|---|
| 422 | upstream_failure | 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. |
Also the common errors: 401 for a missing or expired session or a base token (license_required) and 429 when rate limited.
Web client proxima.walletActivity.getFarms(includeStopped?, limit?, offset?) src/lib/proxima/endpoints/wallet-activity.ts
List farm operations
/activity/farms/{address}/ops Returns the transactions made by one wallet's farm.
- Token
- Upgraded session token, bound to a license.
- Read-only tokens
- Allowed.
- Retry
- Safe to retry
Path parameters
-
addressstring RequiredWallet address. Must be a wallet of the account.ExampleC31EeqtSvpjYHFQxBoP9bBTpqtUWV2avNhjdaN1yem44
Query parameters
-
limitinteger OptionalPage size, from 1 to 200; values outside are clamped. -
offsetinteger OptionalNumber of operations to skip.
Returns 200 OK · application/json
Returns an array of Farm operation objects.
Errors
| Status | Code | When and what to do |
|---|---|---|
| 404 | not_found | The wallet is not on the account. Use wallets from List wallets. |
| 422 | upstream_failure | 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. |
Also the common errors: 401 for a missing or expired session or a base token (license_required) and 429 when rate limited.
Web client proxima.walletActivity.getOps(address, limit?, offset?) src/lib/proxima/endpoints/wallet-activity.ts