Skip to content
API Reference

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

Launch fees

Collect creator fees, manage fee shares and recipients, and handle holder dividends.

A live token earns creator fees on most platforms. These calls collect them, claim pump.fun cashback, change who receives the fees, and read or sell the dividends some platforms pay to holders.

Most of them only apply to some platforms; each endpoint says which. The Launch object reports creator_fees and unclaimed_cashback.

POST /launch/collect-fees/{launch_id}

Claims the creator fees the launch has earned.

Token
Upgraded session token, bound to a license.
Read-only tokens
Refused with 403 read_only_token.
Retry
Safe to retry A repeat claims only what has accrued since. With nothing owed, Solana answers 422 No fees to claim and EVM answers a fee_received of "0".

Answers once the claim transaction has landed. The fields returned depend on the platform: one or several transaction hashes, the amount received, or, for Meteora DAMM, a signature and the native and token legs.

Path parameters

  • launch_id string Required
    Public ID of the launch.
    Example101482937561204

Returns 200 OK · application/json

  • ok boolean
    true when the request succeeded.
  • message string
    Human-readable outcome.
  • tx_hash string
    Transaction hash.
  • tx_hashes array<string>
    Transaction hashes, when several were sent.
  • fee_received string
    Fees received, in base units.
  • note string
    Extra information about the claim.
  • signature string
    Meteora DAMM and Stonk.fun: signature of the claim.
  • fees_native string
    Meteora DAMM: native leg, in base units.
  • fees_token string
    Meteora DAMM: token leg, in base units.
  • amount integer
    Solana: fees received, in base units of the quote token.
  • amount_usd integer | null
    pump.fun: value of amount in micro-USD, when it can be priced.
  • proxima_fee string
    EVM: Proxima's fee on the claim, in base units.
  • already_submitted boolean
    Stonk.fun: the claim was already relayed, and signature is the original one.

Errors

StatusCodeWhen and what to do
400 bad_request launch_id is not a valid launch ID. Pass the launch_id returned when the launch was created, as listed by List the license's launches.
400 bad_request The launch's platform has no creator fees this endpoint can collect. On Solana it collects pump.fun, Bonk.fun, Surge, Bags, Meteora DAMM, Stonk.fun and meme.fun fees. Call it only for a launch on a platform that pays its creator fees.
400 bad_request On EVM, the launch has not been deployed yet, so it has earned no fees. Meteora DAMM answers launch is not deployed yet. Wait until the launch is deployed, then call again.
400 bad_request Anoncoin pays this launch's creator fees into an account it keeps for your API key. Claim these fees from Anoncoin.
400 bad_request On Meteora DAMM, the launch holds no pool position of its own, as with an imported pool. Collect fees only on a pool the launch created.
400 bad_request On Meteora DAMM, the position has no fees yet, or they are worth less than landing the claim costs. Let more fees accrue, then call again.
404 not_found No launch with this ID belongs to your license. Check the ID, and that your token is upgraded onto the license that owns the launch.
409 conflict The launch was imported, so its creator fees belong to whoever created the token. Claim these fees from the wallet that created the token.
409 conflict The launch pays its creator fees to its holders, through pump.fun Holder Rewards or a Stonk.fun reward launch, so the creator has nothing to claim. Don't collect fees on a launch that pays its holders.
409 conflict A partner takes the whole creator fee stream: OTC desks, UsePaid, or Ansem, which keeps the creator. On EVM, a UsePaid launch answers UsePaid claims this launch's creator fees. Don't collect fees on a launch whose fee stream goes to a partner.
409 conflict On meme.fun, the launch doesn't trade a meme.fun curve, or the curve pays a creator other than the launch's dev wallet. Check the launch's dev wallet with Retrieve a launch.
409 conflict On Stonk.fun, an earlier claim on this launch has not landed yet. Wait for the earlier claim to land, then call again.
422 unprocessable Nothing has accrued since the last claim. On EVM, an empty claim answers 200 with a fee_received of "0" instead. Call again once the token has traded more.
422 unprocessable The dev wallet can't pay for the claim. On Solana it needs at least 0.01 SOL; on EVM the message names the wallet that can't pay the gas. Fund the dev wallet, then call again.
422 unprocessable On Meteora DAMM, nothing prices the launch's quote token right now, so the claim can't be weighed against its cost. Call again in a few minutes.
422 upstream_failure The claim transaction failed or did not land. On EVM the service is evm_tx_engine, on Stonk.fun stonkfun. Call again: it claims only what is still owed.
500 internal_error On Solana, the launch has not been deployed yet. Wait until the launch is deployed, then call 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.collectFees(launchId) src/lib/proxima/endpoints/launch/launch.ts

POST /launch/pumpfun/claim-cashback/{launch_id}

Claims the pump.fun cashback the launch has accumulated.

Token
Upgraded session token, bound to a license.
Read-only tokens
Refused with 403 read_only_token.
Retry
Safe to retry A repeat claims only the cashback still unclaimed, then answers 422 No unclaimed cashback.

Path parameters

  • launch_id string Required
    Public ID of the launch.
    Example101482937561204

Returns 200 OK · application/json

  • ok boolean
    true when the request succeeded.
  • message string
    Human-readable outcome.
  • amount number
    Cashback claimed.
  • amount_usd integer | null
    Value of amount in micro-USD, when it can be priced.

Errors

StatusCodeWhen and what to do
400 bad_request launch_id is not a valid launch ID. Pass the launch_id returned when the launch was created, as listed by List the license's launches.
400 unsupported_chain The launch is on an EVM chain. Call this endpoint only for Solana launches.
400 bad_request The launch is not on pump.fun. Claim cashback only on pump.fun launches.
404 not_found No launch with this ID belongs to your license. Check the ID, and that your token is upgraded onto the license that owns the launch.
409 conflict The token was created without pump.fun cashback. Claim cashback only on tokens created with cashback enabled.
409 conflict The launch's deploy has not finished. Wait until the deploy finishes, then call again.
422 unprocessable None of the launch's wallets has cashback left to claim. Call again after the wallets have traded more.
422 unprocessable The funder pays the claim fees and holds less than 0.1 SOL. Top up the launch's funder, listed by List funders, then call again.
422 upstream_failure At least one claim transaction did not land; the others may have. Call again: it claims only the cashback still unclaimed.
500 internal_error The launch has not been deployed yet. Wait until the launch is deployed, then call 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.claimPumpCashback(launchId) src/lib/proxima/endpoints/launch/launch.ts

POST /launch/pumpfun/update-fee-shares/{launch_id}

Changes how the creator fees of a live pump.fun token are split.

Token
Upgraded session token, bound to a license.
Read-only tokens
Refused with 403 read_only_token.
Retry
Safe to retry Sending the same split again leaves the same state, though it sends another transaction.

Path parameters

  • launch_id string Required
    Public ID of the launch.
    Example101482937561204

Body parameters application/json

  • new_shares array<object> Required
    The new split. Shares must add up to 10000.
    Child attributes 4
    • address string Optional
      Recipient wallet.
    • github string Optional
      Recipient GitHub username.
    • charity_id string Optional
      Recipient charity ID.
    • share_bps integer Required
      Share of the fees, in basis points.

Returns 200 OK · application/json

  • ok boolean
    true when the request succeeded.
  • message string
    Human-readable outcome.

Errors

StatusCodeWhen and what to do
400 bad_request launch_id is not a valid launch ID. Pass the launch_id returned when the launch was created, as listed by List the license's launches.
400 unsupported_chain The launch is on an EVM chain. Call this endpoint only for Solana launches.
400 bad_request new_shares is empty, doesn't add up to 10000, gives every charity leg a share_bps of 0, or has a leg with an invalid address, an empty GitHub username, or not exactly one of address, github and charity_id. Send legs that each name one recipient and together add up to 10000.
403 forbidden pump.fun no longer lets the creator change this token's fee split. Keep the current split, which can't be changed anymore.
404 not_found No launch with this ID belongs to your license. Check the ID, and that your token is upgraded onto the license that owns the launch.
409 conflict The launch is imported, uses Holder Rewards, or assigned the whole fee stream at deploy. Update fee shares only on a launch you created whose fees still go to its creator.
422 upstream_failure pump.fun couldn't resolve a charity leg. Check each charity_id, then call again.
422 upstream_failure The update transaction did not land. Call again with the same split.
500 internal_error The launch has not been deployed yet. Wait until the launch is deployed, then call 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.updateFeeShares(launchId, newShares) src/lib/proxima/endpoints/launch/launch.ts

GET /launch/fee-recipient/{launch_id}

Returns where the launch's creator fees go today.

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

Path parameters

  • launch_id string Required
    Public ID of the launch.
    Example101482937561204

Returns 200 OK · application/json

  • ok boolean
    true when the request succeeded.
  • recipient string
    Address the creator fees now go to.
  • tx_hashes array<string>
    Transactions sent to make the change; empty when nothing changed.
  • can_change boolean
    false once the fees go to a holder distributor, which can't be undone.
  • already_set boolean
    The recipient was already the requested one.

Errors

StatusCodeWhen and what to do
400 bad_request launch_id is not a valid launch ID. Pass the launch_id returned when the launch was created, as listed by List the license's launches.
400 unsupported_chain The launch is on Solana. Call this endpoint only for EVM launches.
400 bad_request The launch has not been deployed yet. Wait until the launch is deployed, then call again.
400 bad_request The launch's platform exposes no creator fee recipient. Pons, Pons v2, Znipe, Foci, Lift and Long do. Call it only for a launch on one of those platforms.
404 not_found No launch with this ID belongs to your license. Check the ID, and that your token is upgraded onto the license that owns the launch.

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

POST /launch/fee-recipient/{launch_id}

Points the launch's creator fees at its dev, another wallet, or its holders.

Token
Upgraded session token, bound to a license.
Read-only tokens
Refused with 403 read_only_token.
Retry
Safe to retry Settled on a chain read: when the recipient is already the one asked for, it answers already_set: true and sends nothing.

A holders target first deploys the launchpad's per-launch distributor, and the fees can't be pointed elsewhere afterwards.

Path parameters

  • launch_id string Required
    Public ID of the launch.
    Example101482937561204

Body parameters application/json

  • target object Required
    New recipient.
    Child attributes 2
    • kind enum Required
      Who receives the fees.
      Possible values devwalletholders
    • address string Optional
      Wallet to pay. Required when kind is wallet.

Returns 200 OK · application/json

  • ok boolean
    true when the request succeeded.
  • recipient string
    Address the creator fees now go to.
  • tx_hashes array<string>
    Transactions sent to make the change; empty when nothing changed.
  • can_change boolean
    false once the fees go to a holder distributor, which can't be undone.
  • already_set boolean
    The recipient was already the requested one.

Errors

StatusCodeWhen and what to do
400 bad_request launch_id is not a valid launch ID. Pass the launch_id returned when the launch was created, as listed by List the license's launches.
400 unsupported_chain The launch is on Solana. Call this endpoint only for EVM launches.
400 bad_request target has no kind, an unknown kind, or is a wallet target without a valid address. Send target.kind as dev, wallet or holders, with an address for wallet.
400 bad_request The launch has not been deployed yet. Wait until the launch is deployed, then call again.
400 bad_request The launch's platform can't repoint its creator fees, or has no holder distributor for a holders target. Pons, Pons v2, Znipe and Long can move them, and only Pons v2 and Znipe take holders. Pick a target the launch's platform supports.
400 bad_request The fees already go to the holders' distributor, which can't hand them back; can_change is false. Leave the recipient as it is.
400 bad_request The fee recipient is controlled by a wallet your license doesn't hold. Change the recipient from the wallet that controls it.
404 not_found No launch with this ID belongs to your license. Check the ID, and that your token is upgraded onto the license that owns the launch.
409 conflict UsePaid controls where this launch's creator fees go. Change the recipient through UsePaid.
422 unprocessable The dev wallet can't pay the gas. Fund the dev wallet, then call again.
422 unprocessable The change was sent, but a chain read still shows the old recipient. Read it back with Retrieve the fee recipient, and call again if it hasn't changed.
422 upstream_failure The transaction failed or did not land. Call again: once the recipient is set, a repeat sends nothing.

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

Retrieve dividends

Bearer JWT
GET /launch/dividends/{launch_id}

Returns the dividends the launch wallets hold.

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

On EVM this is the tax a Flap, Argus or Ignix coin pays its holders, answered as the flat fields and again as the one entry of assets. On Solana it is the OTC desks reward, answered as assets only. A launch without dividends answers an error.

Path parameters

  • launch_id string Required
    Public ID of the launch.
    Example101482937561204

Returns 200 OK · application/json

  • token string
    Dividend token.
  • symbol string | null
    Symbol.
  • decimals integer | null
    Decimals.
  • total_atomic string
    Total held, in base units.
  • total_native string | null
    Total value in the chain's native token, in base units (lamports or wei).
  • total_usd string | null
    Total value in micro-USD (millionths of a dollar).
  • assets array<object>
    One entry per dividend token, with the same fields. Solana answers only this list; EVM answers one entry beside the flat fields.

Errors

StatusCodeWhen and what to do
400 bad_request launch_id is not a valid launch ID. Pass the launch_id returned when the launch was created, as listed by List the license's launches.
400 bad_request On EVM, the launch has not been deployed yet. Wait until the launch is deployed, then call again.
404 not_found No launch with this ID belongs to your license. Check the ID, and that your token is upgraded onto the license that owns the launch.
422 unprocessable The launch pays no dividend. On EVM only a taxed Flap, Argus or Ignix coin does; on Solana, an OTC desks reward launch. Call it only for a launch that pays dividends.
422 unprocessable The dividend is the launch's own token. Sell it with Nuke a launch.
422 unprocessable On EVM, the dividend is already the chain's gas token, so there is nothing to sell. Read it as the wallets' native balance with List wallets.
422 unprocessable On Solana, an OTC desks pair reward sits in the launch's trading quote balance rather than as a separate dividend. Manage it through the launch's quote balance.
422 unprocessable None of the launch's wallets holds any dividend right now. Call again once dividends have accrued.
500 internal_error On Solana, the launch has not been deployed yet. Wait until the launch is deployed, then call again.

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

Sell dividends

Bearer JWT
POST /launch/sell-dividends/{launch_id}

Sells the dividends held by the launch wallets.

Token
Upgraded session token, bound to a license.
Read-only tokens
Refused with 403 read_only_token.
Retry
Safe to retry A repeat sells only what the wallets still hold. The answer is 200 even when some legs fail, so check each status in results.

Path parameters

  • launch_id string Required
    Public ID of the launch.
    Example101482937561204

Body parameters application/json

  • wallets array<string> Optional
    Wallets to sell from. Omit for all.
  • slippage_bps integer Optional
    Slippage tolerance, in basis points. Defaults to 50 on Solana.

Returns 200 OK · application/json

  • ok boolean
    true when the request succeeded.
  • results array<object>
    One result per wallet and token.
    Child attributes 6
    • wallet string
      Wallet.
    • token string
      Token handled.
    • status enum
      Outcome.
      Possible values swappedsoldclaimedskippedfailed
    • reason string
      Why it was skipped or failed.
    • amount string
      Amount handled, in base units.
    • tx_hash string
      Transaction hash or signature.

Errors

StatusCodeWhen and what to do
400 bad_request launch_id is not a valid launch ID. Pass the launch_id returned when the launch was created, as listed by List the license's launches.
400 bad_request An entry of wallets is not a valid address, or, on EVM, is not a wallet of this launch (wallet does not belong to this launch). Send addresses of this launch's wallets, as listed by List wallets.
400 bad_request On EVM, the launch has not been deployed yet. Wait until the launch is deployed, then call again.
404 not_found No launch with this ID belongs to your license. Check the ID, and that your token is upgraded onto the license that owns the launch.
422 unprocessable On Solana, an entry of wallets is not a wallet of this launch. Send addresses of this launch's wallets, as listed by List wallets.
422 unprocessable wallets is an empty list. Omit wallets to sell from every launch wallet.
422 unprocessable The launch pays no dividend. On EVM only a taxed Flap, Argus or Ignix coin does; on Solana, an OTC desks reward launch. Call it only for a launch that pays dividends.
422 unprocessable The dividend is the launch's own token. Sell it with Nuke a launch.
422 unprocessable On EVM, the dividend is already the chain's gas token, so there is nothing to sell. Read it as the wallets' native balance with List wallets.
422 unprocessable On Solana, an OTC desks pair reward sits in the launch's trading quote balance rather than as a separate dividend. Manage it through the launch's quote balance.
422 unprocessable None of the launch's wallets, or of the ones named, holds any dividend right now. Call again once dividends have accrued.
500 internal_error On Solana, the launch has not been deployed yet. Wait until the launch is deployed, then call 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.sellDividends(launchId, request) src/lib/proxima/endpoints/launch/launch.ts