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 (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 is enabled, the Generate Activity button opens activity farms instead.
The state of the account's session on a chain.
Attributes
-
statusenumSession state.Nonewhen there is no session to show.Possible valuesRunningCompletedFailedNoneCancelled -
infoobjectSession settings and timing. Absent whenstatusisNone.Child attributes 8
-
started_atintegerUnix timestamp (seconds) at which the session started. -
ended_atintegerUnix timestamp (seconds) at which the session ended. -
loop_amountintegerNumber of buy-and-sell loops requested. -
delayintegerDelay between loops, in milliseconds. -
min_sol_inintegerMinimum buy size per loop, in native base units. -
max_sol_inintegerMaximum buy size per loop, in native base units. -
walletsarray<string>Wallets in the session. -
status_reasonstring | nullWhy the session failed, when it did.
-
Retrieve the session
/wallets/{chain_id}/fake-volume/status Returns the status and settings of the current or last session.
- Token
- Upgraded session token, bound to a license.
- Read-only tokens
- Allowed.
- Retry
- Safe to retry
Path parameters
-
chain_idenum RequiredChain of the session. The web app only offers chains whosegenerate_activityfeature is enabled (currentlysol).Possible valuessolethbscbaserobinhoodmonadarcxlayer
Returns 200 OK · application/json
Returns a Generate activity session object.
Errors
| Status | Code | When and what to do |
|---|---|---|
| 400 | bad_request | chain_id is not a chain the API serves. Use a supported chain_id; monad is no longer accepted. |
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.wallets.fakeVolume.getFakeVolume(chainId) src/lib/proxima/endpoints/wallets/fake-volume.ts
Start a session
/wallets/{chain_id}/fake-volume/run Starts buy-and-sell loops on the given wallets.
- 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 and check whether a session is
Running. Onsola 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.
Path parameters
-
chain_idenum RequiredChain of the session. The web app only offers chains whosegenerate_activityfeature is enabled (currentlysol).Possible valuessolethbscbaserobinhoodmonadarcxlayer
Body parameters application/json
-
pubkeysarray<string> RequiredWallets that trade. They must be wallets of the account. -
min_sol_ininteger RequiredMinimum buy size per loop, in native base units. Greater than 0. -
max_sol_ininteger RequiredMaximum buy size per loop, in native base units. At leastmin_sol_in. -
loop_amountinteger RequiredNumber of loops, from 1 toaged_wallets.max_loops. -
delayinteger RequiredDelay between loops in milliseconds, up toaged_wallets.max_delay. -
platformenum RequiredTrading platform. WithAxiom, the web app budgets an extra 1,000,000 lamports per loop in its balance check.Possible valuesNoneAxiom
Returns 200 OK · application/json
-
okbooleanAlwaystrueon success. -
messagestringHuman-readable confirmation.
Errors
| Status | Code | When and what to do |
|---|---|---|
| 400 | bad_request | chain_id is not a chain the API serves. Use a supported chain_id; monad is no longer accepted. |
| 409 | conflict | 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. |
| 500 | internal_error | 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 | 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 | 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 | 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 | 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 | On sol, pubkeys is empty. Returned as a 500, not a 400. Send at least one wallet in pubkeys. |
| 500 | internal_error | 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 | 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 | On sol, a wallet is not on the account. Returned as a 500, not a 400. Use wallets from List wallets. |
| 500 | internal_error | 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 | On sol, reading the wallets' balances from the RPC failed. Retry after a short wait. |
| 400 | bad_request | On EVM chains, the body has no token_address. Add token_address with the token to trade. |
| 400 | bad_request | On EVM chains, pubkeys is empty. Send at least one wallet in pubkeys. |
| 400 | bad_request | On EVM chains, token_address is not a valid address. Send a valid 0x token address. |
| 400 | bad_request | On EVM chains, a wallet is not on the account. Use wallets from List wallets. |
| 400 | bad_request | On EVM chains, a wallet is watch-only and cannot sign. Use wallets whose keys the account holds. |
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.wallets.fakeVolume.runFakeVolume(chainId, pubkeys, min_sol_in, max_sol_in, loop_amount, delay, platform) src/lib/proxima/endpoints/wallets/fake-volume.ts
Stop a session
/wallets/{chain_id}/fake-volume/cancel Stops the running session before its last loop.
- 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_idenum RequiredChain of the session. The web app only offers chains whosegenerate_activityfeature is enabled (currentlysol).Possible valuessolethbscbaserobinhoodmonadarcxlayer
Returns 200 OK · application/json
-
okbooleanAlwaystrueon success. -
messagestringHuman-readable confirmation.
Errors
| Status | Code | When and what to do |
|---|---|---|
| 400 | bad_request | chain_id is not a chain the API serves. Use a supported chain_id; monad is no longer accepted. |
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.wallets.fakeVolume.cancelFakeVolume(chainId) src/lib/proxima/endpoints/wallets/fake-volume.ts
Discard a session
/wallets/{chain_id}/fake-volume/discard Clears the status of a finished session.
- 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_idenum RequiredChain of the session. The web app only offers chains whosegenerate_activityfeature is enabled (currentlysol).Possible valuessolethbscbaserobinhoodmonadarcxlayer
Returns 200 OK · application/json
-
okbooleanAlwaystrueon success. -
messagestringHuman-readable confirmation.
Errors
| Status | Code | When and what to do |
|---|---|---|
| 400 | bad_request | chain_id is not a chain the API serves. Use a supported chain_id; monad is no longer accepted. |
| 409 | conflict | On sol, the session is still running. EVM chains do not check. Stop it with Stop a session first. |
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.wallets.fakeVolume.discardFakeVolume(chainId) src/lib/proxima/endpoints/wallets/fake-volume.ts