Skip to content
API Reference

Search is only available in production builds. Try building and previewing the site to test it out locally.

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

  • status enum
    Session state. None when there is no session to show.
    Possible values RunningCompletedFailedNoneCancelled
  • info object
    Session settings and timing. Absent when status is None.
    Child attributes 8
    • 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.
GET /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_id enum Required
    Chain of the session. The web app only offers chains whose generate_activity feature is enabled (currently sol).
    Possible values solethbscbaserobinhoodmonadarcxlayer

Returns 200 OK · application/json

Returns a Generate activity session object.

Errors

StatusCodeWhen 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

Bearer JWT
POST /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. 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.

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 solethbscbaserobinhoodmonadarcxlayer

Body parameters application/json

  • 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 NoneAxiom

Returns 200 OK · application/json

  • ok boolean
    Always true on success.
  • message string
    Human-readable confirmation.

Errors

StatusCodeWhen 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

Bearer JWT
POST /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_id enum Required
    Chain of the session. The web app only offers chains whose generate_activity feature is enabled (currently sol).
    Possible values solethbscbaserobinhoodmonadarcxlayer

Returns 200 OK · application/json

  • ok boolean
    Always true on success.
  • message string
    Human-readable confirmation.

Errors

StatusCodeWhen 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

Bearer JWT
POST /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_id enum Required
    Chain of the session. The web app only offers chains whose generate_activity feature is enabled (currently sol).
    Possible values solethbscbaserobinhoodmonadarcxlayer

Returns 200 OK · application/json

  • ok boolean
    Always true on success.
  • message string
    Human-readable confirmation.

Errors

StatusCodeWhen 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