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 Volume bot status object
The launch's Volume Bot session and its counters.
Attributes
-
statusenumSession state.Possible valuesNonePlannedRunningCompletedCancelledFailed -
infoobjectSession details. Absent whenstatusisNone.Child attributes 10
-
paramsobjectThe session parameters, as sent to plan or run. -
started_atinteger | nullUnix timestamp (seconds) the session started. -
ended_atinteger | nullUnix timestamp (seconds) the session ended. -
status_reasonstring | nullWhy the session ended or failed, when known. -
target_volumeinteger | stringTarget volume, raw quote units. -
volume_generatedinteger | stringVolume generated so far, raw quote units. -
net_costinteger | stringNet cost so far (fees and slippage), raw quote units. -
usd_volume_generatedinteger | stringVolume generated so far, micro-USD. -
usd_net_costinteger | stringNet cost so far, micro-USD. -
round_trips_completedintegerBuy-and-sell round trips completed.
-
The Volume estimate object
What a Volume Bot configuration would cost and need, computed without starting it.
Attributes
-
round_tripsintegerRound trips the bot would make. -
costinteger | stringEstimated cost, raw native units. -
quote_costinteger | string | nullEstimated cost in the quote token, raw units. -
min_balance_per_walletinteger | stringNative each wallet needs, raw units. On a quote-denominated launch this covers gas only. -
min_quote_per_walletinteger | string | nullQuote each wallet needs to trade, raw units.nullon a gas-token launch. -
quote_symbolstringSymbol of the quote token. -
quote_decimalsintegerDecimals of the quote token. -
min_duration_secsintegerShortest duration the configuration allows, in seconds. -
walletsarray<string>Wallets the bot would use.
Plan a Volume Bot session
/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_idstring RequiredLaunch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (101Solana,201BSC,202Base,204Ethereum).Example101000000004217
Body parameters application/json
-
modeenum RequiredTrading pattern of the bot.Possible valuesBundleOrganic -
end_conditionobject RequiredWhen the bot stops. Exactly one key is set.Child attributes 9
-
TimeBasedobject OptionalGenerate the target volume over a fixed duration.Child attributes 3
-
target_volumeinteger | string OptionalVolume to generate: raw quote units on Solana, native wei on EVM. Send this ortarget_volume_usd. -
target_volume_usdinteger | string OptionalVolume to generate, micro-USD. Send this ortarget_volume. -
durationinteger RequiredDuration in seconds, at most 86400.
-
-
DelayBasedobject OptionalGenerate the target volume with a random delay between round trips.Child attributes 4
-
target_volumeinteger | string OptionalVolume to generate: raw quote units on Solana, native wei on EVM. Send this ortarget_volume_usd. -
target_volume_usdinteger | string OptionalVolume to generate, micro-USD. Send this ortarget_volume. -
min_delayinteger RequiredMinimum delay in milliseconds (1000–300000). -
max_delayinteger RequiredMaximum delay in milliseconds (1000–300000), at leastmin_delay.
-
-
-
min_amountinteger | string OptionalSmallest trade, raw quote units. Send withmax_amountto override the computed sizes. -
max_amountinteger | string OptionalLargest trade, raw quote units. -
wallet_pubkeysarray<string> | null RequiredLaunch wallets that trade, ornullfor all of them. An empty array is rejected. -
fee_targetinteger | string OptionalSolana only: fee target, raw native units. -
wave_intensitynumber OptionalOrganicmode only: intensity of the volume waves, from0.0(tight buy/sell alternation) to1.0(long waves).
Returns 200 OK · application/json
Returns ok and a confirmation message.
-
okbooleanAlwaystrueon success. -
messagestringHuman-readable confirmation.
Errors
| Status | Code | When 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
Start a Volume Bot session
/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 astarted_atlater 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_idstring RequiredLaunch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (101Solana,201BSC,202Base,204Ethereum).Example101000000004217
Body parameters application/json
-
modeenum RequiredTrading pattern of the bot.Possible valuesBundleOrganic -
end_conditionobject RequiredWhen the bot stops. Exactly one key is set.Child attributes 9
-
TimeBasedobject OptionalGenerate the target volume over a fixed duration.Child attributes 3
-
target_volumeinteger | string OptionalVolume to generate: raw quote units on Solana, native wei on EVM. Send this ortarget_volume_usd. -
target_volume_usdinteger | string OptionalVolume to generate, micro-USD. Send this ortarget_volume. -
durationinteger RequiredDuration in seconds, at most 86400.
-
-
DelayBasedobject OptionalGenerate the target volume with a random delay between round trips.Child attributes 4
-
target_volumeinteger | string OptionalVolume to generate: raw quote units on Solana, native wei on EVM. Send this ortarget_volume_usd. -
target_volume_usdinteger | string OptionalVolume to generate, micro-USD. Send this ortarget_volume. -
min_delayinteger RequiredMinimum delay in milliseconds (1000–300000). -
max_delayinteger RequiredMaximum delay in milliseconds (1000–300000), at leastmin_delay.
-
-
-
min_amountinteger | string OptionalSmallest trade, raw quote units. Send withmax_amountto override the computed sizes. -
max_amountinteger | string OptionalLargest trade, raw quote units. -
wallet_pubkeysarray<string> | null RequiredLaunch wallets that trade, ornullfor all of them. An empty array is rejected. -
fee_targetinteger | string OptionalSolana only: fee target, raw native units. -
wave_intensitynumber OptionalOrganicmode only: intensity of the volume waves, from0.0(tight buy/sell alternation) to1.0(long waves).
Returns 200 OK · application/json
Returns ok and a confirmation message.
-
okbooleanAlwaystrueon success. -
messagestringHuman-readable confirmation. -
session_idstringEVM only: ID of the session that started.
Errors
| Status | Code | When 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
Retrieve Volume Bot status
/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_idstring RequiredLaunch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (101Solana,201BSC,202Base,204Ethereum).Example101000000004217
Returns 200 OK · application/json
Returns a Volume bot status object.
-
statusenumSession state.Possible valuesNonePlannedRunningCompletedCancelledFailed -
infoobjectSession details. Absent whenstatusisNone.Child attributes 10
-
paramsobjectThe session parameters, as sent to plan or run. -
started_atinteger | nullUnix timestamp (seconds) the session started. -
ended_atinteger | nullUnix timestamp (seconds) the session ended. -
status_reasonstring | nullWhy the session ended or failed, when known. -
target_volumeinteger | stringTyped by the web client, but neither chain sends it. -
volume_generatedinteger | stringVolume generated so far, raw quote units. -
net_costinteger | stringNet cost so far (fees and slippage), raw quote units. -
usd_volume_generatedinteger | stringVolume generated so far, micro-USD. -
usd_net_costinteger | stringNet cost so far, micro-USD. -
round_trips_completedintegerBuy-and-sell round trips completed.
-
Errors
| Status | Code | When 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
Estimate a Volume Bot session
/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_idstring RequiredLaunch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (101Solana,201BSC,202Base,204Ethereum).Example101000000004217
Body parameters application/json
-
modeenum RequiredTrading pattern of the bot.Possible valuesBundleOrganic -
end_conditionobject RequiredWhen the bot stops. Exactly one key is set.Child attributes 9
-
TimeBasedobject OptionalGenerate the target volume over a fixed duration.Child attributes 3
-
target_volumeinteger | string OptionalVolume to generate: raw quote units on Solana, native wei on EVM. Send this ortarget_volume_usd. -
target_volume_usdinteger | string OptionalVolume to generate, micro-USD. Send this ortarget_volume. -
durationinteger RequiredDuration in seconds, at most 86400.
-
-
DelayBasedobject OptionalGenerate the target volume with a random delay between round trips.Child attributes 4
-
target_volumeinteger | string OptionalVolume to generate: raw quote units on Solana, native wei on EVM. Send this ortarget_volume_usd. -
target_volume_usdinteger | string OptionalVolume to generate, micro-USD. Send this ortarget_volume. -
min_delayinteger RequiredMinimum delay in milliseconds (1000–300000). -
max_delayinteger RequiredMaximum delay in milliseconds (1000–300000), at leastmin_delay.
-
-
-
min_amountinteger | string OptionalSmallest trade, raw quote units. Send withmax_amountto override the computed sizes. -
max_amountinteger | string OptionalLargest trade, raw quote units. -
wallet_pubkeysarray<string> | null RequiredLaunch wallets that trade, ornullfor all of them. An empty array is rejected. -
fee_targetinteger | string OptionalSolana only: fee target, raw native units. -
wave_intensitynumber OptionalOrganicmode only: intensity of the volume waves, from0.0(tight buy/sell alternation) to1.0(long waves).
Returns 200 OK · application/json
Returns ok and a Volume estimate object under estimate.
-
okbooleanAlwaystrueon success. -
estimateobjectThe estimate.Child attributes 9
-
round_tripsintegerRound trips the bot would make. -
costinteger | stringEstimated cost, raw native units. -
quote_costinteger | string | nullTyped by the web client, but neither chain sends it. -
min_balance_per_walletinteger | stringNative each wallet needs, raw units. On a quote-denominated launch this covers gas only. -
min_quote_per_walletinteger | string | nullEVM only: quote each wallet needs to trade, raw units.nullon a gas-token launch. -
quote_symbolstringEVM only: symbol of the quote token. -
quote_decimalsintegerEVM only: decimals of the quote token. -
min_duration_secsintegerShortest duration the configuration allows, in seconds. -
walletsarray<string>Wallets the bot would use.
-
Errors
| Status | Code | When 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
Cancel a Volume Bot session
/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_idstring RequiredLaunch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (101Solana,201BSC,202Base,204Ethereum).Example101000000004217
Returns 200 OK · application/json
Returns ok and a confirmation message.
-
okbooleanAlwaystrueon success. -
messagestringHuman-readable confirmation.
Errors
| Status | Code | When 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
Discard a Volume Bot session
/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_idstring RequiredLaunch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (101Solana,201BSC,202Base,204Ethereum).Example101000000004217
Returns 200 OK · application/json
Returns ok and a confirmation message.
-
okbooleanAlwaystrueon success. -
messagestringHuman-readable confirmation.
Errors
| Status | Code | When 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