Skip to content
API Reference

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

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.

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_complete boolean
    true when every wallet holds what the plan needs and no per-mint config is pending.
  • stoxes_config_pending boolean
    true only for an instant Stoxes MEV plan whose curve config is not on chain yet.
  • lesgo_config_pending boolean
    true for a Lesgo plan with a supply target whose curve config is not on chain yet.
  • funding_status enum
    State of the launch's funding job.
    Possible values NoneRunningFailed
  • native_funding object
    Native-token funding.
    Child attributes 2
    • total_funding_native integer
      Total native funding the plan needs, raw units.
    • complete boolean
      true when the native funding is in place.
  • quote_funding object
    Quote-token funding, for launches quoted in a token other than the native one.
    Child attributes 3
    • complete boolean
      true when the quote funding is in place.
    • total_quote_funding integer
      Total quote funding the plan needs, in the quote token's atomic units.
    • total_funding_quote integer
      Deprecated wire name of total_quote_funding; read total_quote_funding first.
  • breakdown object
    How the native total splits across the plan. Integers are numbers on Solana and decimal strings on EVM chains.
    Child attributes 8
    • dev_supply_cost integer | string
      Cost of the dev wallet's supply buy.
    • dev_extra_funding integer | string
      Extra funding the dev wallet needs on top of its buy (fees, rent, reserves).
    • mev_extra_funding integer | string
      Extra funding for the MEV wallets.
    • holder_supply_cost integer | string
      Cost of the holders' supply buys.
    • holder_extra_funding integer | string
      Extra funding the holder wallets need on top of their buys.
    • funding_extra_funding integer | string
      Overhead of the funding itself.
    • fee_target_cost integer | string
      Cost of the fee target, when the plan sets one.
    • total integer | string
      Sum of the breakdown.

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_funding integer | string
    Total native funding the plan would need, raw units.
  • expected_supply integer | string
    Token supply the plan's wallets are expected to buy, raw token units.
  • breakdown object
    How expected_funding splits. A multi-launch group (count above 1) returns the group fields instead of the single-launch ones.
    Child attributes 14
    • dev_supply_cost integer | string
      Cost of the dev wallet's supply buy.
    • dev_extra_funding integer | string
      Extra funding the dev wallet needs on top of its buy (fees, rent, reserves).
    • mev_extra_funding integer | string
      Extra funding for the MEV wallets.
    • holder_supply_cost integer | string
      Cost of the holders' supply buys.
    • holder_extra_funding integer | string
      Extra funding the holder wallets need on top of their buys.
    • funding_extra_funding integer | string
      Overhead of the funding itself.
    • fee_target_cost integer | string
      Cost of the fee target, when the plan sets one.
    • total integer | string
      Sum of the breakdown.
    • reserve_seed integer | string
      Multi-launch groups only: seed held in reserve.
    • dev_total integer | string
      Multi-launch groups only: total for the dev wallets.
    • shared_gas integer | string
      Multi-launch groups only: gas shared across members.
    • reserve_gas integer | string
      Multi-launch groups only: gas held in reserve.
    • funder_gas integer | string
      Multi-launch groups only: gas the funder spends.
    • cex_extra_funding integer | string
      Multi-launch groups only: extra funding for CEX withdrawals.
  • max_loss integer | string
    Estimated maximum loss of the plan, raw units.
  • max_loss_post_migration integer | string
    Estimated maximum loss once the token has migrated, raw units.
  • quote_transfer_fee_bps integer | null
    Transfer fee charged by the launch's quote token, in basis points.
  • per_member_max_loss array<integer | string>
    Multi-launch groups only: estimated maximum loss of each member launch.
  • count integer
    Number of launches the estimate covers.
  • supply_cost_bps integer | null
    Cost of the bought supply, in basis points.
  • estimated_duration_ms integer
    Estimated duration of the launch run, in milliseconds.
  • mcap_live number | string | null
    Projected market cap at launch, micro-USD.
  • mcap_before_cleanup number | string | null
    Projected market cap before cleanup, micro-USD.
  • mcap_post_cleanup number | string | null
    Projected market cap after cleanup, micro-USD.
  • mcap_migration number | string | null
    Market cap at which the token migrates, micro-USD.
  • allowlist object
    Allowlist launches only: the planned run, shaped like the Allowlist plan summary object.
GET /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_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 Required funding object.

  • is_funding_complete boolean
    true when every wallet holds what the plan needs and no per-mint config is pending.
  • stoxes_config_pending boolean
    true only for an instant Stoxes MEV plan whose curve config is not on chain yet.
  • lesgo_config_pending boolean
    true for a Lesgo plan with a supply target whose curve config is not on chain yet.
  • funding_status enum
    State of the launch's funding job.
    Possible values NoneRunningFailed
  • native_funding object
    Native-token funding.
    Child attributes 2
    • total_funding_native integer | string
      Total native funding the plan needs, raw units. A decimal string on EVM chains.
    • complete boolean
      true when the native funding is in place.
  • quote_funding object
    Quote-token funding, for launches quoted in a token other than the native one.
    Child attributes 3
    • complete boolean
      true when the quote funding is in place.
    • total_quote_funding integer | string
      Total quote funding the plan needs, in the quote token's atomic units. A decimal string on EVM chains.
    • total_funding_quote integer
      Deprecated wire name of total_quote_funding; read total_quote_funding first.
  • breakdown object
    How the native total splits across the plan. Integers are numbers on Solana and decimal strings on EVM chains.
    Child attributes 8
    • dev_supply_cost integer | string
      Cost of the dev wallet's supply buy.
    • dev_extra_funding integer | string
      Extra funding the dev wallet needs on top of its buy (fees, rent, reserves).
    • mev_extra_funding integer | string
      Extra funding for the MEV wallets.
    • holder_supply_cost integer | string
      Cost of the holders' supply buys.
    • holder_extra_funding integer | string
      Extra funding the holder wallets need on top of their buys.
    • funding_extra_funding integer | string
      Overhead of the funding itself.
    • fee_target_cost integer | string
      Cost of the fee target, when the plan sets one.
    • total integer | string
      Sum of the breakdown.

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.
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

POST /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_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

  • mint_pubkey string Required
    Token mint (Solana) or token address (EVM) of the launch.
  • launch_platform string Required
    Launch platform identifier, e.g. pumpfun.
  • launch_method enum Required
    Launch method of the plan.
    Possible values MevStaggerManualAllowlist
  • scheduled_mode boolean Required
    true for a scheduled (snipe) launch.
  • is_imported boolean Required
    true when the token already exists and was imported.
  • dev_supply string Required
    Supply the dev wallet buys, as an integer string.
  • front_mev_count integer Optional
    Number of front MEV wallets.
  • back_mev_count integer Optional
    Number of back MEV wallets. Must be 0 on EVM chains.
  • temp_holder_count integer Optional
    Number of temporary holder wallets.
  • holder_count integer Required
    Number of holder wallets.
  • buy_native string Optional
    Native amount each holder spends, raw units, as an integer string. Send this or buy_supply.
  • buy_supply string Optional
    Supply the holders buy, as an integer string. Send this or buy_native.
  • funding_type enum Required
    How the wallets get funded.
    Possible values ClassicCex
  • buy_delay string Optional
    Delay between holder buys, as an integer string.
  • front_to_back_delay_ms string Optional
    Delay between the front and back MEV legs in milliseconds, as an integer string.
  • back_to_temp_delay_ms string Optional
    Delay between the back MEV and temporary holder legs in milliseconds, as an integer string.
  • slippage string Optional
    Slippage in basis points, as an integer string.
  • fee_target string Optional
    Fee target, raw units, as an integer string. Solana only; ignored on EVM chains.
  • count string Optional
    Multi-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_funding integer | string
    Total native funding the plan would need, raw units.
  • expected_supply integer | string
    Token supply the plan's wallets are expected to buy, raw token units.
  • breakdown object
    How expected_funding splits. A multi-launch group (count above 1) returns the group fields instead of the single-launch ones.
    Child attributes 14
    • dev_supply_cost integer | string
      Cost of the dev wallet's supply buy.
    • dev_extra_funding integer | string
      Extra funding the dev wallet needs on top of its buy (fees, rent, reserves).
    • mev_extra_funding integer | string
      Extra funding for the MEV wallets.
    • holder_supply_cost integer | string
      Cost of the holders' supply buys.
    • holder_extra_funding integer | string
      Extra funding the holder wallets need on top of their buys.
    • funding_extra_funding integer | string
      Overhead of the funding itself.
    • fee_target_cost integer | string
      Cost of the fee target, when the plan sets one.
    • total integer | string
      Sum of the breakdown.
    • reserve_seed integer | string
      Multi-launch groups only: seed held in reserve.
    • dev_total integer | string
      Multi-launch groups only: total for the dev wallets.
    • shared_gas integer | string
      Multi-launch groups only: gas shared across members.
    • reserve_gas integer | string
      Multi-launch groups only: gas held in reserve.
    • funder_gas integer | string
      Multi-launch groups only: gas the funder spends.
    • cex_extra_funding integer | string
      Multi-launch groups only: extra funding for CEX withdrawals.
  • max_loss integer | string
    Estimated maximum loss of the plan, raw units.
  • max_loss_post_migration integer | string
    Estimated maximum loss once the token has migrated, raw units.
  • quote_transfer_fee_bps integer | null
    Transfer fee charged by the launch's quote token, in basis points.
  • per_member_max_loss array<integer | string>
    Multi-launch groups only: estimated maximum loss of each member launch.
  • count integer
    Number of launches the estimate covers.
  • supply_cost_bps integer | null
    Cost of the bought supply, in basis points.
  • estimated_duration_ms integer
    Estimated duration of the launch run, in milliseconds.
  • mcap_live number | string | null
    Projected market cap at launch, micro-USD.
  • mcap_before_cleanup number | string | null
    Projected market cap before cleanup, micro-USD.
  • mcap_post_cleanup number | string | null
    Projected market cap after cleanup, micro-USD.
  • mcap_migration number | string | null
    Market cap at which the token migrates, micro-USD.
  • allowlist object
    Allowlist launches only: the planned run, shaped like the Allowlist plan summary object.

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.
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

POST /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 adjusted list. 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_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

  • ok boolean
    Always true on success.
  • adjusted array<object>
    Holders whose buy was lowered.
    Child attributes 3
    • pubkey string
      Holder wallet.
    • from string
      Previous planned buy, lamports.
    • to string
      New planned buy, lamports.
  • funded boolean
    Whether the launch now passes the funding check the launch call makes.

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

Bearer JWT
POST /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 rescue once 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_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 message: Successfully withdrew, or No fund to rescue when the proxies are empty.

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

POST /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.complete is true there 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_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 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.

  • ok boolean
    true on success. On EVM chains, false with HTTP 200 when some wallets failed.
  • 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 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

POST /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.swap event 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_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

  • direction enum Required
    native_to_quote spends the native token to buy the quote token; quote_to_native sells the quote token for the native token.
    Possible values quote_to_nativenative_to_quote
  • swap_mode enum Optional
    Which end of each swap amount fixes.
    Possible values exact_inexact_out
  • wallets array<object> Optional
    Wallets to swap from. Each must belong to the launch; the funder may be named explicitly.
    Child attributes 2
    • address string Required
      Wallet address.
    • amount string Optional
      Amount, raw units, as an integer string.
  • slippage_bps integer Optional
    Slippage tolerance in basis points.

Returns 200 OK · application/json

  • ok boolean
    true when the batch ran.
  • results array<object>
    One entry per wallet.
    Child attributes 6
    • wallet string
      Wallet address.
    • token string
      Token involved, when relevant.
    • status enum
      Outcome for this wallet.
      Possible values swappedskippedfailed
    • reason string
      Why the wallet was skipped or failed.
    • amount string
      Fixed-end amount, raw units.
    • tx_hash string
      EVM only: hash of the swap transaction. Solana results carry no signature.

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

POST /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_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

  • direction enum Required
    native_to_quote spends the native token to buy the quote token; quote_to_native sells the quote token for the native token.
    Possible values quote_to_nativenative_to_quote
  • amount string Required
    Input amount, raw units, as an integer string. Must be greater than 0.
  • slippage_bps integer Optional
    Slippage tolerance in basis points.

Returns 200 OK · application/json

Returns the route's quote. Amounts are raw units, as decimal strings.

  • ok boolean
    true when a route was found.
  • swap_mode enum
    Which end of the swap is fixed.
    Possible values ExactInExactOut
  • input_mint string
    Mint (or token address) spent.
  • output_mint string
    Mint (or token address) received.
  • in_amount string
    Input amount, raw units.
  • out_amount string
    Output amount, raw units.
  • other_amount_threshold string
    Slippage-adjusted bound on the non-fixed end: minimum output for ExactIn, maximum input for ExactOut.
  • price_impact_pct string | null
    Price impact of the route, in percent. Always null on EVM chains, and null on Solana when the route reports none.
  • slippage_bps integer
    Slippage applied to the threshold, in basis points.

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

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

  • direction enum Required
    native_to_quote spends the native token to buy the quote token; quote_to_native sells the quote token for the native token.
    Possible values quote_to_nativenative_to_quote
  • amount string Required
    Output amount wanted, raw units, as an integer string. Must be greater than 0.
  • slippage_bps integer Optional
    Slippage tolerance in basis points.

Returns 200 OK · application/json

Returns the route's quote. Amounts are raw units, as decimal strings.

  • ok boolean
    true when a route was found.
  • swap_mode enum
    Which end of the swap is fixed.
    Possible values ExactInExactOut
  • input_mint string
    Mint (or token address) spent.
  • output_mint string
    Mint (or token address) received.
  • in_amount string
    Input amount, raw units.
  • out_amount string
    Output amount, raw units.
  • other_amount_threshold string
    Slippage-adjusted bound on the non-fixed end: minimum output for ExactIn, maximum input for ExactOut.
  • price_impact_pct string | null
    Price impact of the route, in percent. Always null on EVM chains, and null on Solana when the route reports none.
  • slippage_bps integer
    Slippage applied to the threshold, in basis points.

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

POST /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_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

  • direction enum Required
    native_to_quote spends the native token to buy the quote token; quote_to_native sells the quote token for the native token.
    Possible values quote_to_nativenative_to_quote
  • wallets array<string> Optional
    Wallet addresses to include. Omit or send an empty array for all launch wallets.

Returns 200 OK · application/json

  • ok boolean
    Always true on success.
  • wallets array<object>
    Per-wallet maximum.
    Child attributes 2
    • address string
      Wallet address.
    • max_in string
      Maximum input, raw units.
  • total_max_in string
    Sum of max_in, raw units.

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