Launch funding
Price what a launch needs funded, fit holder buys to balances, recover stranded funds and convert funding into the launch's quote token.
Funding endpoints price a launch plan and move the native and quote balances held by the launch's wallets. Amounts are raw chain units: lamports on Solana, wei on EVM chains, and the quote token's atomic units for quote amounts.
The /quote/* endpoints convert between the chain's native token and a launch's quote token (for example USDC) inside the launch's own wallets. A multi-launch group is gas-token only: quote endpoints answer 400 for it.
- GET
/launch/funding/get-required-funding/{launch_id} - POST
/launch/funding/get-expected-funding/{launch_id} - POST
/launch/funding/fit-to-balances/{launch_id} - POST
/launch/funding/rescue-funding/{launch_id} - POST
/launch/funding/swap-to-quote/{launch_id} - POST
/quote/swap/{launch_id} - POST
/quote/estimate-out/{launch_id} - POST
/quote/estimate-in/{launch_id} - POST
/quote/max/{launch_id}
The Required funding object
What the launch's saved plan still needs before it can go out. Amounts are raw chain units: lamports on Solana, wei on EVM chains; quote amounts are in the quote token's atomic units.
Attributes
-
is_funding_completebooleantruewhen every wallet holds what the plan needs and no per-mint config is pending. -
stoxes_config_pendingbooleantrueonly for an instant Stoxes MEV plan whose curve config is not on chain yet. -
lesgo_config_pendingbooleantruefor a Lesgo plan with a supply target whose curve config is not on chain yet. -
funding_statusenumState of the launch's funding job.Possible valuesNoneRunningFailed -
native_fundingobjectNative-token funding.Child attributes 2
-
total_funding_nativeintegerTotal native funding the plan needs, raw units. -
completebooleantruewhen the native funding is in place.
-
-
quote_fundingobjectQuote-token funding, for launches quoted in a token other than the native one.Child attributes 3
-
completebooleantruewhen the quote funding is in place. -
total_quote_fundingintegerTotal quote funding the plan needs, in the quote token's atomic units. -
total_funding_quoteintegerDeprecated wire name oftotal_quote_funding; readtotal_quote_fundingfirst.
-
-
breakdownobjectHow the native total splits across the plan. Integers are numbers on Solana and decimal strings on EVM chains.Child attributes 8
-
dev_supply_costinteger | stringCost of the dev wallet's supply buy. -
dev_extra_fundinginteger | stringExtra funding the dev wallet needs on top of its buy (fees, rent, reserves). -
mev_extra_fundinginteger | stringExtra funding for the MEV wallets. -
holder_supply_costinteger | stringCost of the holders' supply buys. -
holder_extra_fundinginteger | stringExtra funding the holder wallets need on top of their buys. -
funding_extra_fundinginteger | stringOverhead of the funding itself. -
fee_target_costinteger | stringCost of the fee target, when the plan sets one. -
totalinteger | stringSum of the breakdown.
-
The Expected funding object
The funding a plan would need, priced from the request body rather than from a saved plan. Integer amounts are raw chain units; they arrive as numbers on Solana and as decimal strings on EVM chains.
Attributes
-
expected_fundinginteger | stringTotal native funding the plan would need, raw units. -
expected_supplyinteger | stringToken supply the plan's wallets are expected to buy, raw token units. -
breakdownobjectHowexpected_fundingsplits. A multi-launch group (countabove 1) returns the group fields instead of the single-launch ones.Child attributes 14
-
dev_supply_costinteger | stringCost of the dev wallet's supply buy. -
dev_extra_fundinginteger | stringExtra funding the dev wallet needs on top of its buy (fees, rent, reserves). -
mev_extra_fundinginteger | stringExtra funding for the MEV wallets. -
holder_supply_costinteger | stringCost of the holders' supply buys. -
holder_extra_fundinginteger | stringExtra funding the holder wallets need on top of their buys. -
funding_extra_fundinginteger | stringOverhead of the funding itself. -
fee_target_costinteger | stringCost of the fee target, when the plan sets one. -
totalinteger | stringSum of the breakdown. -
reserve_seedinteger | stringMulti-launch groups only: seed held in reserve. -
dev_totalinteger | stringMulti-launch groups only: total for the dev wallets. -
shared_gasinteger | stringMulti-launch groups only: gas shared across members. -
reserve_gasinteger | stringMulti-launch groups only: gas held in reserve. -
funder_gasinteger | stringMulti-launch groups only: gas the funder spends. -
cex_extra_fundinginteger | stringMulti-launch groups only: extra funding for CEX withdrawals.
-
-
max_lossinteger | stringEstimated maximum loss of the plan, raw units. -
max_loss_post_migrationinteger | stringEstimated maximum loss once the token has migrated, raw units. -
quote_transfer_fee_bpsinteger | nullTransfer fee charged by the launch's quote token, in basis points. -
per_member_max_lossarray<integer | string>Multi-launch groups only: estimated maximum loss of each member launch. -
countintegerNumber of launches the estimate covers. -
supply_cost_bpsinteger | nullCost of the bought supply, in basis points. -
estimated_duration_msintegerEstimated duration of the launch run, in milliseconds. -
mcap_livenumber | string | nullProjected market cap at launch, micro-USD. -
mcap_before_cleanupnumber | string | nullProjected market cap before cleanup, micro-USD. -
mcap_post_cleanupnumber | string | nullProjected market cap after cleanup, micro-USD. -
mcap_migrationnumber | string | nullMarket cap at which the token migrates, micro-USD. -
allowlistobjectAllowlist launches only: the planned run, shaped like the Allowlist plan summary object.
Retrieve required funding
/launch/funding/get-required-funding/{launch_id} Returns how much native and quote funding the launch's saved plan needs and whether it is in place.
- Token
- Upgraded session token, bound to a license.
- Read-only tokens
- Allowed.
- Retry
- Safe to retry
The funding page and the launch flow read this to decide whether the launch can start.
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 Required funding object.
-
is_funding_completebooleantruewhen every wallet holds what the plan needs and no per-mint config is pending. -
stoxes_config_pendingbooleantrueonly for an instant Stoxes MEV plan whose curve config is not on chain yet. -
lesgo_config_pendingbooleantruefor a Lesgo plan with a supply target whose curve config is not on chain yet. -
funding_statusenumState of the launch's funding job.Possible valuesNoneRunningFailed -
native_fundingobjectNative-token funding.Child attributes 2
-
total_funding_nativeinteger | stringTotal native funding the plan needs, raw units. A decimal string on EVM chains. -
completebooleantruewhen the native funding is in place.
-
-
quote_fundingobjectQuote-token funding, for launches quoted in a token other than the native one.Child attributes 3
-
completebooleantruewhen the quote funding is in place. -
total_quote_fundinginteger | stringTotal quote funding the plan needs, in the quote token's atomic units. A decimal string on EVM chains. -
total_funding_quoteintegerDeprecated wire name oftotal_quote_funding; readtotal_quote_fundingfirst.
-
-
breakdownobjectHow the native total splits across the plan. Integers are numbers on Solana and decimal strings on EVM chains.Child attributes 8
-
dev_supply_costinteger | stringCost of the dev wallet's supply buy. -
dev_extra_fundinginteger | stringExtra funding the dev wallet needs on top of its buy (fees, rent, reserves). -
mev_extra_fundinginteger | stringExtra funding for the MEV wallets. -
holder_supply_costinteger | stringCost of the holders' supply buys. -
holder_extra_fundinginteger | stringExtra funding the holder wallets need on top of their buys. -
funding_extra_fundinginteger | stringOverhead of the funding itself. -
fee_target_costinteger | stringCost of the fee target, when the plan sets one. -
totalinteger | stringSum of the breakdown.
-
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. |
| 404 | not_found | Solana: the saved plan is incomplete, for example it has no funder or no holder wallets. A plan with no method answers No launch method saved. Save a complete plan with Update the launch plan, then read the funding again. |
| 400 | bad_request | EVM: the launch has no saved plan yet. The same check answers No funder wallet configured, No holder wallets saved or No holder amounts saved for a partial plan. Save a complete plan with Update the launch plan, then read the funding again. |
| 400 | bad_request | The launch is a multi-launch group container whose group plan has not been saved. Save the group plan with Update the launch plan first. |
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.funding.getRequiredFunding(launchId) src/lib/proxima/endpoints/launch/funding.ts
Estimate funding for a plan
/launch/funding/get-expected-funding/{launch_id} Prices a launch plan sent in the body and returns the funding it would need.
- Token
- Upgraded session token, bound to a license.
- Read-only tokens
- Refused with
403 read_only_token. - Retry
- Safe to retry Prices the plan without saving or sending anything.
The launch wizard calls this while the plan is being edited, before it is saved. The client serializes large integers (dev_supply, buy_native, buy_supply, fee_target) and the delay, slippage and count fields as decimal strings. For a multi-launch group container the body is ignored and the saved group plan is priced.
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
-
mint_pubkeystring RequiredToken mint (Solana) or token address (EVM) of the launch. -
launch_platformstring RequiredLaunch platform identifier, e.g.pumpfun. -
launch_methodenum RequiredLaunch method of the plan.Possible valuesMevStaggerManualAllowlist -
scheduled_modeboolean Requiredtruefor a scheduled (snipe) launch. -
is_importedboolean Requiredtruewhen the token already exists and was imported. -
dev_supplystring RequiredSupply the dev wallet buys, as an integer string. -
front_mev_countinteger OptionalNumber of front MEV wallets. -
back_mev_countinteger OptionalNumber of back MEV wallets. Must be 0 on EVM chains. -
temp_holder_countinteger OptionalNumber of temporary holder wallets. -
holder_countinteger RequiredNumber of holder wallets. -
buy_nativestring OptionalNative amount each holder spends, raw units, as an integer string. Send this orbuy_supply. -
buy_supplystring OptionalSupply the holders buy, as an integer string. Send this orbuy_native. -
funding_typeenum RequiredHow the wallets get funded.Possible valuesClassicCex -
buy_delaystring OptionalDelay between holder buys, as an integer string. -
front_to_back_delay_msstring OptionalDelay between the front and back MEV legs in milliseconds, as an integer string. -
back_to_temp_delay_msstring OptionalDelay between the back MEV and temporary holder legs in milliseconds, as an integer string. -
slippagestring OptionalSlippage in basis points, as an integer string. -
fee_targetstring OptionalFee target, raw units, as an integer string. Solana only; ignored on EVM chains. -
countstring OptionalMulti-launch attempt count, as an integer string. Above 1 the estimate uses the launch-group model (EVM).
Returns 200 OK · application/json
Returns an Expected funding object.
-
expected_fundinginteger | stringTotal native funding the plan would need, raw units. -
expected_supplyinteger | stringToken supply the plan's wallets are expected to buy, raw token units. -
breakdownobjectHowexpected_fundingsplits. A multi-launch group (countabove 1) returns the group fields instead of the single-launch ones.Child attributes 14
-
dev_supply_costinteger | stringCost of the dev wallet's supply buy. -
dev_extra_fundinginteger | stringExtra funding the dev wallet needs on top of its buy (fees, rent, reserves). -
mev_extra_fundinginteger | stringExtra funding for the MEV wallets. -
holder_supply_costinteger | stringCost of the holders' supply buys. -
holder_extra_fundinginteger | stringExtra funding the holder wallets need on top of their buys. -
funding_extra_fundinginteger | stringOverhead of the funding itself. -
fee_target_costinteger | stringCost of the fee target, when the plan sets one. -
totalinteger | stringSum of the breakdown. -
reserve_seedinteger | stringMulti-launch groups only: seed held in reserve. -
dev_totalinteger | stringMulti-launch groups only: total for the dev wallets. -
shared_gasinteger | stringMulti-launch groups only: gas shared across members. -
reserve_gasinteger | stringMulti-launch groups only: gas held in reserve. -
funder_gasinteger | stringMulti-launch groups only: gas the funder spends. -
cex_extra_fundinginteger | stringMulti-launch groups only: extra funding for CEX withdrawals.
-
-
max_lossinteger | stringEstimated maximum loss of the plan, raw units. -
max_loss_post_migrationinteger | stringEstimated maximum loss once the token has migrated, raw units. -
quote_transfer_fee_bpsinteger | nullTransfer fee charged by the launch's quote token, in basis points. -
per_member_max_lossarray<integer | string>Multi-launch groups only: estimated maximum loss of each member launch. -
countintegerNumber of launches the estimate covers. -
supply_cost_bpsinteger | nullCost of the bought supply, in basis points. -
estimated_duration_msintegerEstimated duration of the launch run, in milliseconds. -
mcap_livenumber | string | nullProjected market cap at launch, micro-USD. -
mcap_before_cleanupnumber | string | nullProjected market cap before cleanup, micro-USD. -
mcap_post_cleanupnumber | string | nullProjected market cap after cleanup, micro-USD. -
mcap_migrationnumber | string | nullMarket cap at which the token migrates, micro-USD. -
allowlistobjectAllowlist launches only: the planned run, shaped like the Allowlist plan summary object.
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. |
| 422 | unprocessable | Solana: the launch runs a stored script and its saved plan is incomplete, for example no funder or holder wallets. Complete the saved plan with Update the launch plan, then price it again. |
| 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 | The launch is a multi-launch group container whose group plan has not been saved. A group prices its saved plan and ignores the body. Save the group plan with Update the launch plan first. |
| 500 | internal_error | Solana: front_mev_count is above what the platform and quote allow. Lower front_mev_count and price the plan again. |
| 500 | internal_error | Solana: back_mev_count is above the maximum. Lower back_mev_count and price the plan again. |
| 500 | internal_error | Solana: a Mev plan has front_mev_count set to 0. Set front_mev_count to at least 1 for a Mev plan. |
| 500 | internal_error | Solana: a Manual plan sets front_mev_count. Siblings: Back MEV wallets are not allowed for manual launches, Temp holder wallets are not allowed for manual launches, fee_target is not supported for manual launches. Send a Manual plan with no MEV or temporary holder wallets and no fee_target. |
| 500 | internal_error | Solana: is_imported is true while scheduled_mode is false. Set scheduled_mode to true for an imported token. |
| 500 | internal_error | Solana: mint_pubkey is not a valid address. Send the launch's mint address in mint_pubkey. |
| 400 | bad_request | EVM: back_mev_count is not 0. Send back_mev_count: 0 on EVM chains. |
| 400 | bad_request | EVM: temp_holder_count is set without front MEV wallets. The same check answers temp_holder count must be >= front_mev count and temp_holder count must be <= holder count. Keep temp_holder_count between front_mev_count and holder_count, with at least one front MEV wallet. |
| 400 | bad_request | EVM: the launch platform does not run a front MEV, temporary holder, holder cascade. Send temp_holder_count: 0 for this platform. |
| 400 | bad_request | EVM: a Mev plan on a platform that needs front MEV wallets has front_mev_count set to 0. Set front_mev_count to at least 1. |
| 400 | bad_request | EVM: a Manual plan sets front_mev_count. Send front_mev_count: 0 for a Manual plan. |
| 400 | bad_request | EVM: is_imported is true while scheduled_mode is false. Set scheduled_mode to true for an imported token. |
| 400 | bad_request | EVM: the holder amount uses the wrong unit for the plan: buy_supply is required on an instant Mev launch and buy_native on every other. Send buy_supply for an instant Mev plan and buy_native otherwise. |
| 400 | bad_request | EVM: count is outside 1 to 15. Send a count from 1 to 15. |
| 404 | not_found | Solana: launch_method is Allowlist but the launch has no allowlist curve run. Use Allowlist only for a launch created as an allowlist curve launch. |
| 409 | conflict | Solana, Allowlist: the run has started, so its plan can no longer be priced again. Read the run from Retrieve allowlist run status instead. |
| 422 | unprocessable | Solana, Allowlist: with this many holders the ten largest holdings, the pool vault included, reach the launch's top-ten limit. Raise holder_count so the holdings spread under the limit. |
| 422 | upstream_failure | Solana, Allowlist: no SOL price is available to convert the plan's quote needs. The body adds service. Retry in a few seconds. |
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.funding.getExpectedFunding(launchId, launchInfo) src/lib/proxima/endpoints/launch/funding.ts
Fit holder buys to balances
/launch/funding/fit-to-balances/{launch_id} Lowers each underfunded holder's planned buy to what its wallet balance covers.
- Token
- Upgraded session token, bound to a license.
- Read-only tokens
- Refused with
403 read_only_token. - Retry
- Safe to retry A repeat recomputes from the current balances and leaves holders already fitted as they are, so it answers an empty
adjustedlist. It never raises a buy back.
Lets a draft launch go out without topping up short holders. Available for Solana launches with the Stagger or Manual method and a SOL quote. The dev wallet and the creation payer are not touched: the launch still refuses to start while either is short. Takes no 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
Returns 200 OK · application/json
-
okbooleanAlwaystrueon success. -
adjustedarray<object>Holders whose buy was lowered.Child attributes 3
-
pubkeystringHolder wallet. -
fromstringPrevious planned buy, lamports. -
tostringNew planned buy, lamports.
-
-
fundedbooleanWhether the launch now passes the funding check the launch call makes.
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 | The launch is on an EVM chain. Fund the holders instead: only Solana launches (IDs starting with 101) can be fitted. |
| 500 | internal_error | The saved plan is incomplete, for example it has no funder or no holder wallets. A plan with no method answers No launch method saved. Save a complete plan with Update the launch plan, then fit again. |
| 409 | conflict | The launch is no longer a draft. Read the launch with Retrieve a launch: only a draft can be fitted. |
| 500 | internal_error | The launch's funding job is still running. Wait for the funding job to finish or cancel it from List funding jobs, then fit again. |
| 400 | bad_request | The launch's plan is a script. Fund the holders instead with Fund the launch wallets. |
| 400 | bad_request | The launch method is not Stagger or Manual. Fund the holders instead: only Stagger and Manual plans can be fitted. |
| 400 | bad_request | The launch is quoted in a token other than SOL. Fund the holders instead: only SOL-quoted launches can be fitted. |
| 500 | internal_error | The wallet balances could not be read from the RPC. Nothing was changed. Retry after a short wait. |
| 422 | unprocessable | A pump.fun Stagger launch with no dev buy: fitted to their balances, every holder's buy drops to 0, so the launch would buy nothing. Nothing was saved. Fund the holder wallets with Fund the launch wallets before fitting. |
| 409 | conflict | The launch left draft while the buys were being fitted, so nothing was saved. Read the launch with Retrieve a launch: only a draft can be fitted. |
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.funding.fitToBalances(launchId) src/lib/proxima/endpoints/launch/funding.ts
Rescue funding
/launch/funding/rescue-funding/{launch_id} Sweeps SOL left on the launch's funding proxy accounts back to the funder.
- Token
- Upgraded session token, bound to a license.
- Read-only tokens
- Refused with
403 read_only_token. - Retry
- Safe to retry Each call sweeps what the proxy accounts hold at that moment back to the funder, so a repeat only moves what is left and answers
No fund to rescueonce they are empty.
Applies to Classic funding on Solana. When a proxy cannot pay its own transaction fee, the funder pays it. The linked funding job is cancelled. Other funding types answer No fund to rescue. Takes no 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
Returns 200 OK · application/json
Returns ok and a message: Successfully withdrew, or No fund to rescue when the proxies are empty.
-
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 | unsupported_chain | The launch is not on Solana. The body adds chain. Call it only for Solana launches (IDs starting with 101). |
| 500 | internal_error | The launch's funding job is still running. Wait for the funding job to finish or cancel it from List funding jobs, then rescue again. |
| 422 | unprocessable | Some proxy accounts cannot pay their own fee and the funder holds too little to pay it for them. Nothing is sent for those proxies. Send SOL to the funder wallet, then rescue again. |
| 422 | unprocessable | Some proxy accounts still hold lamports two seconds after the sweep, because a transfer did not land in time. The funding job is cancelled anyway. Call it again: each call sweeps only what the proxies still hold. |
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.funding.rescueFunding(launchId) src/lib/proxima/endpoints/launch/funding.ts
Swap funding to the quote token
/launch/funding/swap-to-quote/{launch_id} Buys, in each launch wallet, the quote token it still needs, paying with its native funding.
- Token
- Upgraded session token, bound to a license.
- Read-only tokens
- Refused with
403 read_only_token. - Retry
- Check before retrying Read Retrieve required funding first: once
quote_funding.completeistruethere is nothing left to buy. A repeat only buys what each wallet still lacks, but cannot see a swap that is still landing.
Used on launches quoted in a token other than the native one, after native funding is complete. Each wallet keeps what it needs for its own gas. Takes no 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
Returns 200 OK · application/json
Returns ok and a message. Besides Successfully swapped, the call can succeed with Native quote launch, no swap needed, No funding needed or Total native funding not completed without swapping. On EVM chains the body also carries swapped (wallet, tx_hash) and failed lists, the message can be All wallets already hold their quote, and a partial run answers HTTP 200 with ok: false and Swapped <n> of <m> wallets or Failed to approve quote spenders.
-
okbooleantrueon success. On EVM chains,falsewith HTTP 200 when some wallets failed. -
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 | The launch is a multi-launch group container, which only holds the gas token. Call it on a single launch: a multi-launch group has no quote token. |
| 422 | unprocessable | Solana: the quote's market is too thin: buying the funding's quote and selling it back would lose more than the allowed band. Variants: <quote_mint> sells back to nothing, <quote_mint> cannot be bought: <reason>. Fund the wallets with the quote token directly, or plan a launch with a deeper quote. |
| 500 | internal_error | Solana: a wallet's swap got no confirmation after three attempts and may still land. Other wallets may already have swapped. Wait a minute, then check Retrieve required funding before calling again. |
| 500 | internal_error | Solana: a wallet's swap failed on chain on every attempt. Other wallets may already have swapped. Call it again: wallets that already hold their quote are skipped. |
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.funding.swapToQuote(launchId) src/lib/proxima/endpoints/launch/funding.ts
Swap between native and quote
/quote/swap/{launch_id} Swaps between the native token and the launch's quote token in the selected launch wallets.
- Token
- Upgraded session token, bound to a license.
- Read-only tokens
- Refused with
403 read_only_token. - Retry
- Check before retrying Look for the call's
launch.swapevent in List a launch's activity events before sending it again: it lists each wallet's outcome and is written when the batch finishes. A repeat with explicit amounts swaps them a second time.
Each wallet is handled on its own and reported in results; one wallet failing does not fail the call. With exact_in, amount is the input to spend and 0 sweeps the whole input balance. With exact_out, amount is the output to receive and 0 skips the wallet. Omit wallets to sweep every launch wallet (the funder excluded) as exact_in. The client sends wallet amounts as integer strings.
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
-
directionenum Requirednative_to_quotespends the native token to buy the quote token;quote_to_nativesells the quote token for the native token.Possible valuesquote_to_nativenative_to_quote -
swap_modeenum OptionalWhich end of each swapamountfixes.Possible valuesexact_inexact_out -
walletsarray<object> OptionalWallets to swap from. Each must belong to the launch; the funder may be named explicitly.Child attributes 2
-
addressstring RequiredWallet address. -
amountstring OptionalAmount, raw units, as an integer string.
-
-
slippage_bpsinteger OptionalSlippage tolerance in basis points.
Returns 200 OK · application/json
-
okbooleantruewhen the batch ran. -
resultsarray<object>One entry per wallet.Child attributes 6
-
walletstringWallet address. -
tokenstringToken involved, when relevant. -
statusenumOutcome for this wallet.Possible valuesswappedskippedfailed -
reasonstringWhy the wallet was skipped or failed. -
amountstringFixed-end amount, raw units. -
tx_hashstringEVM only: hash of the swap transaction. Solana results carry no signature.
-
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 | The launch is a multi-launch group container, which only holds the gas token. Call it on a single launch: a multi-launch group has no quote token. |
| 422 | unprocessable | The launch is quoted in the chain's native token, so there is no quote token to swap. Call it only for launches quoted in a token other than the native one. |
| 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 | Solana: an entry of wallets is not a valid address. Send base58 Solana addresses in wallets[].address. |
| 400 | bad_request | EVM: an entry of wallets is not a valid address. Send 0x addresses in wallets[].address. |
| 422 | unprocessable | Solana: an entry of wallets is not a wallet of this launch. On EVM chains that wallet is reported as skipped instead. Name only the launch's own wallets, as listed by Retrieve a launch. |
| 422 | unprocessable | Solana: fees from a recent sell are still settling on the launch's wallets (waited 30 seconds). Retry in a few seconds. |
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.funding.quoteSwap(launchId, request) src/lib/proxima/endpoints/launch/funding.ts
Estimate swap output
/quote/estimate-out/{launch_id} Prices an exact-input swap between the native token and the quote token without executing 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 sent.
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
-
directionenum Requirednative_to_quotespends the native token to buy the quote token;quote_to_nativesells the quote token for the native token.Possible valuesquote_to_nativenative_to_quote -
amountstring RequiredInput amount, raw units, as an integer string. Must be greater than 0. -
slippage_bpsinteger OptionalSlippage tolerance in basis points.
Returns 200 OK · application/json
Returns the route's quote. Amounts are raw units, as decimal strings.
-
okbooleantruewhen a route was found. -
swap_modeenumWhich end of the swap is fixed.Possible valuesExactInExactOut -
input_mintstringMint (or token address) spent. -
output_mintstringMint (or token address) received. -
in_amountstringInput amount, raw units. -
out_amountstringOutput amount, raw units. -
other_amount_thresholdstringSlippage-adjusted bound on the non-fixed end: minimum output forExactIn, maximum input forExactOut. -
price_impact_pctstring | nullPrice impact of the route, in percent. Alwaysnullon EVM chains, andnullon Solana when the route reports none. -
slippage_bpsintegerSlippage applied to the threshold, in basis points.
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 | amount is 0. Send an amount greater than 0. |
| 400 | bad_request | The launch is a multi-launch group container, which only holds the gas token. Call it on a single launch: a multi-launch group has no quote token. |
| 422 | unprocessable | The launch is quoted in the chain's native token, so there is no quote token to swap. Call it only for launches quoted in a token other than the native one. |
| 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. |
| 500 | internal_error | Solana: the swap router returned no route for this amount. A timeout answers jupiter quote timed out. Retry, or try a smaller amount. |
| 422 | unprocessable | EVM: no pool can fill this amount. Try a smaller amount. |
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.funding.estimateOut(launchId, request) src/lib/proxima/endpoints/launch/funding.ts
Estimate swap input
/quote/estimate-in/{launch_id} Prices an exact-output swap between the native token and the quote token without executing 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 sent.
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
-
directionenum Requirednative_to_quotespends the native token to buy the quote token;quote_to_nativesells the quote token for the native token.Possible valuesquote_to_nativenative_to_quote -
amountstring RequiredOutput amount wanted, raw units, as an integer string. Must be greater than 0. -
slippage_bpsinteger OptionalSlippage tolerance in basis points.
Returns 200 OK · application/json
Returns the route's quote. Amounts are raw units, as decimal strings.
-
okbooleantruewhen a route was found. -
swap_modeenumWhich end of the swap is fixed.Possible valuesExactInExactOut -
input_mintstringMint (or token address) spent. -
output_mintstringMint (or token address) received. -
in_amountstringInput amount, raw units. -
out_amountstringOutput amount, raw units. -
other_amount_thresholdstringSlippage-adjusted bound on the non-fixed end: minimum output forExactIn, maximum input forExactOut. -
price_impact_pctstring | nullPrice impact of the route, in percent. Alwaysnullon EVM chains, andnullon Solana when the route reports none. -
slippage_bpsintegerSlippage applied to the threshold, in basis points.
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 | amount is 0. Send an amount greater than 0. |
| 400 | bad_request | The launch is a multi-launch group container, which only holds the gas token. Call it on a single launch: a multi-launch group has no quote token. |
| 422 | unprocessable | The launch is quoted in the chain's native token, so there is no quote token to swap. Call it only for launches quoted in a token other than the native one. |
| 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. |
| 500 | internal_error | Solana: the swap router returned no route for this amount. A timeout answers jupiter quote timed out. Retry, or try a smaller amount. |
| 422 | unprocessable | EVM: no pool can fill this amount. Try a smaller amount. |
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.funding.estimateIn(launchId, request) src/lib/proxima/endpoints/launch/funding.ts
Retrieve maximum swap inputs
/quote/max/{launch_id} Returns the largest input each launch wallet can swap in the given direction, and their total.
- 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 sent.
For native_to_quote, the maximum is the spendable native balance after the fee reserve; for quote_to_native, the whole quote balance. The app uses it to cap inputs so a "max" swap is not skipped.
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
-
directionenum Requirednative_to_quotespends the native token to buy the quote token;quote_to_nativesells the quote token for the native token.Possible valuesquote_to_nativenative_to_quote -
walletsarray<string> OptionalWallet addresses to include. Omit or send an empty array for all launch wallets.
Returns 200 OK · application/json
-
okbooleanAlwaystrueon success. -
walletsarray<object>Per-wallet maximum.Child attributes 2
-
addressstringWallet address. -
max_instringMaximum input, raw units.
-
-
total_max_instringSum ofmax_in, raw units.
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 | The launch is a multi-launch group container, which only holds the gas token. Call it on a single launch: a multi-launch group has no quote token. |
| 422 | unprocessable | The launch is quoted in the chain's native token, so there is no quote token to swap. Call it only for launches quoted in a token other than the native one. |
| 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 | Solana: an entry of wallets is not a valid address. Send base58 Solana addresses in wallets. |
| 400 | bad_request | EVM: an entry of wallets is not a valid address. Send 0x addresses in wallets. |
| 422 | unprocessable | An entry of wallets is not a wallet of this launch. Name only the launch's own wallets, as listed by Retrieve a launch. |
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.funding.quoteMax(launchId, request) src/lib/proxima/endpoints/launch/funding.ts