Skip to content
API Reference

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

Volume Bot

Generate trading volume on a launch with buy-and-sell round trips from its wallets.

The Volume Bot trades the launch's token back and forth from the launch's wallets until it reaches a target volume, either over a fixed duration (TimeBased) or with random delays between round trips (DelayBased). Targets are set in raw quote units or in micro-USD.

Estimate a configuration first to see its cost and the balance each wallet needs. The web app polls the status endpoint every 5 seconds.

On an EVM multi-launch container, the session endpoints answer 400 (multi-launch container: sessions run on the winner launch once it resolves); call them on the winning launch instead.

The launch's Volume Bot session and its counters.

Attributes

  • status enum
    Session state.
    Possible values NonePlannedRunningCompletedCancelledFailed
  • info object
    Session details. Absent when status is None.
    Child attributes 10
    • params object
      The session parameters, as sent to plan or run.
    • started_at integer | null
      Unix timestamp (seconds) the session started.
    • ended_at integer | null
      Unix timestamp (seconds) the session ended.
    • status_reason string | null
      Why the session ended or failed, when known.
    • target_volume integer | string
      Target volume, raw quote units.
    • volume_generated integer | string
      Volume generated so far, raw quote units.
    • net_cost integer | string
      Net cost so far (fees and slippage), raw quote units.
    • usd_volume_generated integer | string
      Volume generated so far, micro-USD.
    • usd_net_cost integer | string
      Net cost so far, micro-USD.
    • round_trips_completed integer
      Buy-and-sell round trips completed.

What a Volume Bot configuration would cost and need, computed without starting it.

Attributes

  • round_trips integer
    Round trips the bot would make.
  • cost integer | string
    Estimated cost, raw native units.
  • quote_cost integer | string | null
    Estimated cost in the quote token, raw units.
  • min_balance_per_wallet integer | string
    Native each wallet needs, raw units. On a quote-denominated launch this covers gas only.
  • min_quote_per_wallet integer | string | null
    Quote each wallet needs to trade, raw units. null on a gas-token launch.
  • quote_symbol string
    Symbol of the quote token.
  • quote_decimals integer
    Decimals of the quote token.
  • min_duration_secs integer
    Shortest duration the configuration allows, in seconds.
  • wallets array<string>
    Wallets the bot would use.
POST /launch/volume/plan/{launch_id}

Saves a Volume Bot session as Planned; on Solana it starts with the launch.

Token
Upgraded session token, bound to a license.
Read-only tokens
Refused with 403 read_only_token.
Retry
Safe to retry Planning again replaces the planned configuration. Nothing trades until the session starts.

On Solana the token does not need to be launched yet, and the planned session starts when the launch runs. On EVM the token must already be launched, nothing starts the session automatically, and the next Start a Volume Bot session call runs the planned parameters instead of the ones in its body.

Path parameters

  • launch_id string Required
    Launch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (101 Solana, 201 BSC, 202 Base, 204 Ethereum).
    Example101000000004217

Body parameters application/json

  • mode enum Required
    Trading pattern of the bot.
    Possible values BundleOrganic
  • end_condition object Required
    When the bot stops. Exactly one key is set.
    Child attributes 9
    • TimeBased object Optional
      Generate the target volume over a fixed duration.
      Child attributes 3
      • target_volume integer | string Optional
        Volume to generate: raw quote units on Solana, native wei on EVM. Send this or target_volume_usd.
      • target_volume_usd integer | string Optional
        Volume to generate, micro-USD. Send this or target_volume.
      • duration integer Required
        Duration in seconds, at most 86400.
    • DelayBased object Optional
      Generate the target volume with a random delay between round trips.
      Child attributes 4
      • target_volume integer | string Optional
        Volume to generate: raw quote units on Solana, native wei on EVM. Send this or target_volume_usd.
      • target_volume_usd integer | string Optional
        Volume to generate, micro-USD. Send this or target_volume.
      • min_delay integer Required
        Minimum delay in milliseconds (1000–300000).
      • max_delay integer Required
        Maximum delay in milliseconds (1000–300000), at least min_delay.
  • min_amount integer | string Optional
    Smallest trade, raw quote units. Send with max_amount to override the computed sizes.
  • max_amount integer | string Optional
    Largest trade, raw quote units.
  • wallet_pubkeys array<string> | null Required
    Launch wallets that trade, or null for all of them. An empty array is rejected.
  • fee_target integer | string Optional
    Solana only: fee target, raw native units.
  • wave_intensity number Optional
    Organic mode only: intensity of the volume waves, from 0.0 (tight buy/sell alternation) to 1.0 (long waves).

Returns 200 OK · application/json

Returns ok and a confirmation message.

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

Errors

StatusCodeWhen and what to do
400 bad_request launch_id is not a chain-encoded launch ID. Pass the 15-digit chain-encoded launch ID exactly as the API returned it.
404 not_found No launch with this ID belongs to the license in your token. Check the launch ID and that your token is upgraded onto the license that owns the launch.
400 bad_request EVM: launch_id is a multi-launch group container. This route loads the launch itself, so it answers with the launch-level wording rather than the session one. Call it with the winning member's launch ID once the group resolves.
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 end_condition sets neither target_volume nor target_volume_usd, or sets it to 0. EVM answers 500 internal_error with Provide target_volume or target_volume_usd, target_volume must be > 0 or target_volume_usd must be > 0. Set exactly one of target_volume or target_volume_usd to a positive value.
400 bad_request end_condition sets both target_volume and target_volume_usd. EVM sends the same message with 500 internal_error. Send only one of the two targets.
400 bad_request Solana: TimeBased.duration is 0 or above 86400 seconds. EVM refuses only 0, with 500 internal_error and duration must be > 0. Set duration between 1 and 86400 seconds.
400 bad_request Solana: at the largest trade size, the target needs more trades than fit in duration, counting at least 8 seconds per trade. Increase duration, lower the target or raise max_amount.
400 bad_request Solana: with explicit amounts, the target needs more than 60 round trips per minute. Raise min_amount and max_amount, lower the target or increase duration.
400 bad_request Solana: DelayBased.min_delay is under 1000 ms or max_delay is over 300000 ms. Keep both delays between 1000 and 300000 ms.
400 bad_request DelayBased.min_delay is greater than max_delay. EVM sends the same message with 500 internal_error. Set min_delay at or below max_delay.
400 bad_request Solana: a DelayBased session omits min_amount or max_amount. Send both min_amount and max_amount with a DelayBased end condition.
400 bad_request Only one of min_amount and max_amount is set. EVM answers 500 internal_error with provide both min_amount and max_amount, or neither. Send both amounts, or neither to let the bot size the trades.
400 bad_request Solana: min_amount or max_amount is worth less than 0.0001 SOL (100000 lamports) in the launch quote. Raise both amounts to at least the equivalent of 0.0001 SOL.
400 bad_request Solana: min_amount is greater than max_amount. EVM answers 500 internal_error with require 0 < min_amount <= max_amount, also when min_amount is 0. Set min_amount at or below max_amount.
400 bad_request wave_intensity is outside 0.0–1.0. EVM sends the same message with 500 internal_error. Send a wave_intensity between 0 and 1.
400 bad_request Solana: wallet_pubkeys is an empty array. Send null to use every holder wallet, or list at least one wallet.
400 bad_request Solana: an entry of wallet_pubkeys is not a valid Solana address. Correct or remove the malformed address.
404 not_found Solana: an entry of wallet_pubkeys is not one of the launch's wallets. Add the wallet with Add wallets to a launch, or remove it from the list.
409 conflict Solana: a Volume Bot session is running for this launch. Wait for it to end or stop it with Cancel a Volume Bot session first.
422 unprocessable Solana: wallet_pubkeys is null and the launch has no holder wallets. Add holder wallets with Add wallets to a launch, or list wallets in wallet_pubkeys.
422 upstream_failure Solana: the launch quote has no price right now, so trade bounds cannot be computed. The body adds service: "price_feed". Retry in a few seconds.
400 bad_request EVM: the token is still a draft. Unlike Solana, EVM only plans a session on a launched token. Launch the token first with Launch a token.
500 internal_error EVM: a Volume Bot session is already running for this launch. Wait for it to end or stop it with Cancel a Volume Bot session first.
500 internal_error EVM: no entry of wallet_pubkeys is a wallet of the launch. List addresses of the launch's own wallets, or send null to use all of them.
500 internal_error EVM: wallet_pubkeys is an empty array, or the launch holds no usable wallet. Send null to use every launch wallet, or list at least one launch wallet.
500 internal_error EVM: mode is Bundle on a chain that has no bundle relay. Use Organic mode on this chain.
500 internal_error EVM: the target is smaller than one trade of max_amount, typically a target sent in whole units instead of wei. Send target_volume in wei, or target_volume_usd in micro-USD.
500 internal_error EVM: the launch names a quote token that cannot be resolved right now. Retry in a few seconds.
500 internal_error EVM: target_volume_usd is set and the chain's native price is unavailable. Retry in a few seconds, or send target_volume in wei instead.

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.launch.volume.planVolume(launchId, params) src/lib/proxima/endpoints/launch/volume.ts

POST /launch/volume/run/{launch_id}

Starts a Volume Bot session right away on a launched token.

Token
Upgraded session token, bound to a license.
Read-only tokens
Refused with 403 read_only_token.
Retry
Check before retrying Read Retrieve Volume Bot status first: Running, or a started_at later than your first call, means it went through. A second run is refused while a session runs.

The token must be launched. On Solana, listed wallets that are not launch wallets are looked up among the license's wallets. On EVM, when the launch has a Planned session, the planned parameters run and the parameters in this body are ignored.

Path parameters

  • launch_id string Required
    Launch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (101 Solana, 201 BSC, 202 Base, 204 Ethereum).
    Example101000000004217

Body parameters application/json

  • mode enum Required
    Trading pattern of the bot.
    Possible values BundleOrganic
  • end_condition object Required
    When the bot stops. Exactly one key is set.
    Child attributes 9
    • TimeBased object Optional
      Generate the target volume over a fixed duration.
      Child attributes 3
      • target_volume integer | string Optional
        Volume to generate: raw quote units on Solana, native wei on EVM. Send this or target_volume_usd.
      • target_volume_usd integer | string Optional
        Volume to generate, micro-USD. Send this or target_volume.
      • duration integer Required
        Duration in seconds, at most 86400.
    • DelayBased object Optional
      Generate the target volume with a random delay between round trips.
      Child attributes 4
      • target_volume integer | string Optional
        Volume to generate: raw quote units on Solana, native wei on EVM. Send this or target_volume_usd.
      • target_volume_usd integer | string Optional
        Volume to generate, micro-USD. Send this or target_volume.
      • min_delay integer Required
        Minimum delay in milliseconds (1000–300000).
      • max_delay integer Required
        Maximum delay in milliseconds (1000–300000), at least min_delay.
  • min_amount integer | string Optional
    Smallest trade, raw quote units. Send with max_amount to override the computed sizes.
  • max_amount integer | string Optional
    Largest trade, raw quote units.
  • wallet_pubkeys array<string> | null Required
    Launch wallets that trade, or null for all of them. An empty array is rejected.
  • fee_target integer | string Optional
    Solana only: fee target, raw native units.
  • wave_intensity number Optional
    Organic mode only: intensity of the volume waves, from 0.0 (tight buy/sell alternation) to 1.0 (long waves).

Returns 200 OK · application/json

Returns ok and a confirmation message.

  • ok boolean
    Always true on success.
  • message string
    Human-readable confirmation.
  • session_id string
    EVM only: ID of the session that started.

Errors

StatusCodeWhen and what to do
400 bad_request launch_id is not a chain-encoded launch ID. Pass the 15-digit chain-encoded launch ID exactly as the API returned it.
404 not_found No launch with this ID belongs to the license in your token. Check the launch ID and that your token is upgraded onto the license that owns the launch.
400 bad_request EVM: launch_id is a multi-launch group container. This route loads the launch itself, so it answers with the launch-level wording rather than the session one. Call it with the winning member's launch ID once the group resolves.
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 end_condition sets neither target_volume nor target_volume_usd, or sets it to 0. EVM answers 500 internal_error with Provide target_volume or target_volume_usd, target_volume must be > 0 or target_volume_usd must be > 0. Set exactly one of target_volume or target_volume_usd to a positive value.
400 bad_request end_condition sets both target_volume and target_volume_usd. EVM sends the same message with 500 internal_error. Send only one of the two targets.
400 bad_request Solana: TimeBased.duration is 0 or above 86400 seconds. EVM refuses only 0, with 500 internal_error and duration must be > 0. Set duration between 1 and 86400 seconds.
400 bad_request Solana: at the largest trade size, the target needs more trades than fit in duration, counting at least 8 seconds per trade. Increase duration, lower the target or raise max_amount.
400 bad_request Solana: with explicit amounts, the target needs more than 60 round trips per minute. Raise min_amount and max_amount, lower the target or increase duration.
400 bad_request Solana: DelayBased.min_delay is under 1000 ms or max_delay is over 300000 ms. Keep both delays between 1000 and 300000 ms.
400 bad_request DelayBased.min_delay is greater than max_delay. EVM sends the same message with 500 internal_error. Set min_delay at or below max_delay.
400 bad_request Solana: a DelayBased session omits min_amount or max_amount. Send both min_amount and max_amount with a DelayBased end condition.
400 bad_request Only one of min_amount and max_amount is set. EVM answers 500 internal_error with provide both min_amount and max_amount, or neither. Send both amounts, or neither to let the bot size the trades.
400 bad_request Solana: min_amount or max_amount is worth less than 0.0001 SOL (100000 lamports) in the launch quote. Raise both amounts to at least the equivalent of 0.0001 SOL.
400 bad_request Solana: min_amount is greater than max_amount. EVM answers 500 internal_error with require 0 < min_amount <= max_amount, also when min_amount is 0. Set min_amount at or below max_amount.
400 bad_request wave_intensity is outside 0.0–1.0. EVM sends the same message with 500 internal_error. Send a wave_intensity between 0 and 1.
422 upstream_failure Solana: the launch quote has no price right now, so trade bounds cannot be computed. The body adds service: "price_feed". Retry in a few seconds.
500 internal_error Solana: the token is still a draft. EVM answers 400 bad_request with token not launched. Launch the token first with Launch a token.
500 internal_error Solana: a Volume Bot session is already running for this launch. Wait for it to end or stop it with Cancel a Volume Bot session first.
500 internal_error Solana: wallet_pubkeys is an empty array. Send null to use every holder wallet, or list at least one wallet.
500 internal_error Solana: an entry of wallet_pubkeys is not a valid Solana address. Correct or remove the malformed address.
500 internal_error Solana: none of the listed wallets belongs to the launch or the license's wallets, or wallet_pubkeys is null and the launch has no holder wallets. List wallets of the launch or license, or add holder wallets with Add wallets to a launch.
500 internal_error Solana: target_volume_usd is set and the SOL price is unavailable. Retry in a few seconds, or send target_volume instead.
500 internal_error Solana, quote-token launch: no wallet holds the 0.05 SOL it keeps for fees. Fund the wallets with about 0.05 SOL each.
500 internal_error Solana, SOL-quoted launch: no wallet holds more than the 0.05 SOL fee buffer plus the smallest trade. Fund the wallets, then start the session again.
500 internal_error Solana, quote-token launch: no wallet holds enough of the quote token for the smallest trade. Swap the wallets into the quote token with Swap funding to the quote token, then start again.
500 internal_error Solana: at the size the balances allow, the target needs more trades than fit in duration. The session is recorded as Failed with this reason. Fund the wallets, lower the target or increase duration.
400 bad_request EVM: the token is still a draft. The token must be launched before a session starts. Launch the token first with Launch a token.
500 internal_error EVM: a Volume Bot session is already running for this launch. Wait for it to end or stop it with Cancel a Volume Bot session first.
500 internal_error EVM: no entry of wallet_pubkeys is a wallet of the launch. List addresses of the launch's own wallets, or send null to use all of them.
500 internal_error EVM: wallet_pubkeys is an empty array, or the launch holds no usable wallet. Send null to use every launch wallet, or list at least one launch wallet.
500 internal_error EVM: mode is Bundle on a chain that has no bundle relay. Use Organic mode on this chain.
500 internal_error EVM: the target is smaller than one trade of max_amount, typically a target sent in whole units instead of wei. Send target_volume in wei, or target_volume_usd in micro-USD.
500 internal_error EVM: the launch names a quote token that cannot be resolved right now. Retry in a few seconds.
500 internal_error EVM: target_volume_usd is set and the chain's native price is unavailable. Retry in a few seconds, or send target_volume in wei instead.
500 internal_error EVM: no wallet holds more native than the gas reserve a round trip needs. Fund the launch wallets with native gas, then start again.
500 internal_error EVM, launch whose quote is paid from the native balance: no wallet can afford min_amount after the gas reserve. Fund the launch wallets, then start again.
500 internal_error EVM, quote-token launch: no wallet holds min_amount of the quote token. Swap the wallets into the quote token with Swap funding to the quote token, then start again.

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.launch.volume.runVolume(launchId, params) src/lib/proxima/endpoints/launch/volume.ts

GET /launch/volume/status/{launch_id}

Returns the launch's Volume Bot session and its counters.

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

Path parameters

  • launch_id string Required
    Launch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (101 Solana, 201 BSC, 202 Base, 204 Ethereum).
    Example101000000004217

Returns 200 OK · application/json

Returns a Volume bot status object.

  • status enum
    Session state.
    Possible values NonePlannedRunningCompletedCancelledFailed
  • info object
    Session details. Absent when status is None.
    Child attributes 10
    • params object
      The session parameters, as sent to plan or run.
    • started_at integer | null
      Unix timestamp (seconds) the session started.
    • ended_at integer | null
      Unix timestamp (seconds) the session ended.
    • status_reason string | null
      Why the session ended or failed, when known.
    • target_volume integer | string
      Typed by the web client, but neither chain sends it.
    • volume_generated integer | string
      Volume generated so far, raw quote units.
    • net_cost integer | string
      Net cost so far (fees and slippage), raw quote units.
    • usd_volume_generated integer | string
      Volume generated so far, micro-USD.
    • usd_net_cost integer | string
      Net cost so far, micro-USD.
    • round_trips_completed integer
      Buy-and-sell round trips completed.

Errors

StatusCodeWhen and what to do
400 bad_request launch_id is not a chain-encoded launch ID. Pass the 15-digit chain-encoded launch ID exactly as the API returned it.
404 not_found No launch with this ID belongs to the license in your token. Check the launch ID and that your token is upgraded onto the license that owns the launch.
400 bad_request launch_id is a multi-launch group container; sessions run on the winning member launch. Call it with the winning member's launch ID once the group resolves.

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.launch.volume.getVolumeStatus(launchId) src/lib/proxima/endpoints/launch/volume.ts

POST /launch/volume/estimate/{launch_id}

Computes the cost, round trips and per-wallet balance a configuration needs, without starting it.

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 saved or sent.

Takes the same body as plan and run. The client returns only the estimate object to its callers. On EVM the token must already be launched. On Solana the listed wallets are not checked against the launch.

Path parameters

  • launch_id string Required
    Launch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (101 Solana, 201 BSC, 202 Base, 204 Ethereum).
    Example101000000004217

Body parameters application/json

  • mode enum Required
    Trading pattern of the bot.
    Possible values BundleOrganic
  • end_condition object Required
    When the bot stops. Exactly one key is set.
    Child attributes 9
    • TimeBased object Optional
      Generate the target volume over a fixed duration.
      Child attributes 3
      • target_volume integer | string Optional
        Volume to generate: raw quote units on Solana, native wei on EVM. Send this or target_volume_usd.
      • target_volume_usd integer | string Optional
        Volume to generate, micro-USD. Send this or target_volume.
      • duration integer Required
        Duration in seconds, at most 86400.
    • DelayBased object Optional
      Generate the target volume with a random delay between round trips.
      Child attributes 4
      • target_volume integer | string Optional
        Volume to generate: raw quote units on Solana, native wei on EVM. Send this or target_volume_usd.
      • target_volume_usd integer | string Optional
        Volume to generate, micro-USD. Send this or target_volume.
      • min_delay integer Required
        Minimum delay in milliseconds (1000–300000).
      • max_delay integer Required
        Maximum delay in milliseconds (1000–300000), at least min_delay.
  • min_amount integer | string Optional
    Smallest trade, raw quote units. Send with max_amount to override the computed sizes.
  • max_amount integer | string Optional
    Largest trade, raw quote units.
  • wallet_pubkeys array<string> | null Required
    Launch wallets that trade, or null for all of them. An empty array is rejected.
  • fee_target integer | string Optional
    Solana only: fee target, raw native units.
  • wave_intensity number Optional
    Organic mode only: intensity of the volume waves, from 0.0 (tight buy/sell alternation) to 1.0 (long waves).

Returns 200 OK · application/json

Returns ok and a Volume estimate object under estimate.

  • ok boolean
    Always true on success.
  • estimate object
    The estimate.
    Child attributes 9
    • round_trips integer
      Round trips the bot would make.
    • cost integer | string
      Estimated cost, raw native units.
    • quote_cost integer | string | null
      Typed by the web client, but neither chain sends it.
    • min_balance_per_wallet integer | string
      Native each wallet needs, raw units. On a quote-denominated launch this covers gas only.
    • min_quote_per_wallet integer | string | null
      EVM only: quote each wallet needs to trade, raw units. null on a gas-token launch.
    • quote_symbol string
      EVM only: symbol of the quote token.
    • quote_decimals integer
      EVM only: decimals of the quote token.
    • min_duration_secs integer
      Shortest duration the configuration allows, in seconds.
    • wallets array<string>
      Wallets the bot would use.

Errors

StatusCodeWhen and what to do
400 bad_request launch_id is not a chain-encoded launch ID. Pass the 15-digit chain-encoded launch ID exactly as the API returned it.
404 not_found No launch with this ID belongs to the license in your token. Check the launch ID and that your token is upgraded onto the license that owns the launch.
400 bad_request EVM: launch_id is a multi-launch group container. This route loads the launch itself, so it answers with the launch-level wording rather than the session one. Call it with the winning member's launch ID once the group resolves.
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 end_condition sets neither target_volume nor target_volume_usd, or sets it to 0. EVM answers 500 internal_error with Provide target_volume or target_volume_usd, target_volume must be > 0 or target_volume_usd must be > 0. Set exactly one of target_volume or target_volume_usd to a positive value.
400 bad_request end_condition sets both target_volume and target_volume_usd. EVM sends the same message with 500 internal_error. Send only one of the two targets.
400 bad_request Solana: TimeBased.duration is 0 or above 86400 seconds. EVM refuses only 0, with 500 internal_error and duration must be > 0. Set duration between 1 and 86400 seconds.
400 bad_request Solana: at the largest trade size, the target needs more trades than fit in duration, counting at least 8 seconds per trade. Increase duration, lower the target or raise max_amount.
400 bad_request Solana: with explicit amounts, the target needs more than 60 round trips per minute. Raise min_amount and max_amount, lower the target or increase duration.
400 bad_request Solana: DelayBased.min_delay is under 1000 ms or max_delay is over 300000 ms. Keep both delays between 1000 and 300000 ms.
400 bad_request DelayBased.min_delay is greater than max_delay. EVM sends the same message with 500 internal_error. Set min_delay at or below max_delay.
400 bad_request Solana: a DelayBased session omits min_amount or max_amount. Send both min_amount and max_amount with a DelayBased end condition.
400 bad_request Only one of min_amount and max_amount is set. EVM answers 500 internal_error with provide both min_amount and max_amount, or neither. Send both amounts, or neither to let the bot size the trades.
400 bad_request Solana: min_amount or max_amount is worth less than 0.0001 SOL (100000 lamports) in the launch quote. Raise both amounts to at least the equivalent of 0.0001 SOL.
400 bad_request Solana: min_amount is greater than max_amount. EVM answers 500 internal_error with require 0 < min_amount <= max_amount, also when min_amount is 0. Set min_amount at or below max_amount.
400 bad_request wave_intensity is outside 0.0–1.0. EVM sends the same message with 500 internal_error. Send a wave_intensity between 0 and 1.
422 upstream_failure Solana: the launch quote has no price right now, so trade bounds cannot be computed. The body adds service: "price_feed". Retry in a few seconds.
422 upstream_failure Solana: target_volume_usd is set and the SOL price is unavailable. The body adds service: "price_feed". Retry in a few seconds, or send target_volume instead.
400 bad_request Solana: the computed average trade size is 0. EVM answers 500 internal_error with average amount would be 0. Raise the target volume, or set min_amount and max_amount explicitly.
422 unprocessable Solana: wallet_pubkeys is an empty array, or it is null and the launch has no holder wallets. Send null to use every holder wallet, or add holder wallets with Add wallets to a launch.
400 bad_request EVM: the token is still a draft. Unlike Solana, EVM only estimates a session on a launched token. Launch the token first with Launch a token.
500 internal_error EVM: no entry of wallet_pubkeys is a wallet of the launch. List addresses of the launch's own wallets, or send null to use all of them.
500 internal_error EVM: wallet_pubkeys is an empty array, or the launch holds no usable wallet. Send null to use every launch wallet, or list at least one launch wallet.
500 internal_error EVM: mode is Bundle on a chain that has no bundle relay. Use Organic mode on this chain.
500 internal_error EVM: the target is smaller than one trade of max_amount, typically a target sent in whole units instead of wei. Send target_volume in wei, or target_volume_usd in micro-USD.
500 internal_error EVM: the launch names a quote token that cannot be resolved right now. Retry in a few seconds.
500 internal_error EVM: target_volume_usd is set and the chain's native price is unavailable. Retry in a few seconds, or send target_volume in wei instead.

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.launch.volume.estimateVolume(launchId, params) src/lib/proxima/endpoints/launch/volume.ts

POST /launch/volume/cancel/{launch_id}

Stops the launch's planned or running Volume Bot session.

Token
Upgraded session token, bound to a license.
Read-only tokens
Refused with 403 read_only_token.
Retry
Safe to retry Cancelling again has no further effect.

On Solana it marks the launch's latest session Cancelled whatever its state, including a Planned or finished one, and answers ok when there is none. On EVM only a Running session is cancelled; a Planned one stays planned until discarded.

Path parameters

  • launch_id string Required
    Launch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (101 Solana, 201 BSC, 202 Base, 204 Ethereum).
    Example101000000004217

Returns 200 OK · application/json

Returns ok and a confirmation message.

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

Errors

StatusCodeWhen and what to do
400 bad_request launch_id is not a chain-encoded launch ID. Pass the 15-digit chain-encoded launch ID exactly as the API returned it.
404 not_found No launch with this ID belongs to the license in your token. Check the launch ID and that your token is upgraded onto the license that owns the launch.
400 bad_request launch_id is a multi-launch group container; sessions run on the winning member launch. Call it with the winning member's launch ID once the group resolves.

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.launch.volume.cancelVolume(launchId) src/lib/proxima/endpoints/launch/volume.ts

POST /launch/volume/discard/{launch_id}

Clears a planned or finished Volume Bot session from the launch.

Token
Upgraded session token, bound to a license.
Read-only tokens
Refused with 403 read_only_token.
Retry
Safe to retry Discarding again has no further effect.

On Solana a running session is refused with 409. On EVM the call answers ok and leaves a running session in place.

Path parameters

  • launch_id string Required
    Launch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (101 Solana, 201 BSC, 202 Base, 204 Ethereum).
    Example101000000004217

Returns 200 OK · application/json

Returns ok and a confirmation message.

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

Errors

StatusCodeWhen and what to do
400 bad_request launch_id is not a chain-encoded launch ID. Pass the 15-digit chain-encoded launch ID exactly as the API returned it.
404 not_found No launch with this ID belongs to the license in your token. Check the launch ID and that your token is upgraded onto the license that owns the launch.
400 bad_request launch_id is a multi-launch group container; sessions run on the winning member launch. Call it with the winning member's launch ID once the group resolves.
409 conflict Solana: a Volume Bot session is running. EVM does not refuse: it answers ok and leaves the running session in place. Stop it with Cancel a Volume Bot session first, then discard.

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.launch.volume.discardVolume(launchId) src/lib/proxima/endpoints/launch/volume.ts