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.
Collect creator fees
/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 claimand EVM answers afee_receivedof"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_idstring RequiredPublic ID of the launch.Example101482937561204
Returns 200 OK · application/json
-
okbooleantruewhen the request succeeded. -
messagestringHuman-readable outcome. -
tx_hashstringTransaction hash. -
tx_hashesarray<string>Transaction hashes, when several were sent. -
fee_receivedstringFees received, in base units. -
notestringExtra information about the claim. -
signaturestringMeteora DAMM and Stonk.fun: signature of the claim. -
fees_nativestringMeteora DAMM: native leg, in base units. -
fees_tokenstringMeteora DAMM: token leg, in base units. -
amountintegerSolana: fees received, in base units of the quote token. -
amount_usdinteger | nullpump.fun: value ofamountin micro-USD, when it can be priced. -
proxima_feestringEVM: Proxima's fee on the claim, in base units. -
already_submittedbooleanStonk.fun: the claim was already relayed, andsignatureis the original one.
Errors
| Status | Code | When 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
Claim pump.fun cashback
/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_idstring RequiredPublic ID of the launch.Example101482937561204
Returns 200 OK · application/json
-
okbooleantruewhen the request succeeded. -
messagestringHuman-readable outcome. -
amountnumberCashback claimed. -
amount_usdinteger | nullValue ofamountin micro-USD, when it can be priced.
Errors
| Status | Code | When 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
Retrieve the fee recipient
/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_idstring RequiredPublic ID of the launch.Example101482937561204
Returns 200 OK · application/json
-
okbooleantruewhen the request succeeded. -
recipientstringAddress the creator fees now go to. -
tx_hashesarray<string>Transactions sent to make the change; empty when nothing changed. -
can_changebooleanfalseonce the fees go to a holder distributor, which can't be undone. -
already_setbooleanThe recipient was already the requested one.
Errors
| Status | Code | When 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
Set the fee recipient
/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: trueand 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_idstring RequiredPublic ID of the launch.Example101482937561204
Body parameters application/json
-
targetobject RequiredNew recipient.Child attributes 2
-
kindenum RequiredWho receives the fees.Possible valuesdevwalletholders -
addressstring OptionalWallet to pay. Required whenkindiswallet.
-
Returns 200 OK · application/json
-
okbooleantruewhen the request succeeded. -
recipientstringAddress the creator fees now go to. -
tx_hashesarray<string>Transactions sent to make the change; empty when nothing changed. -
can_changebooleanfalseonce the fees go to a holder distributor, which can't be undone. -
already_setbooleanThe recipient was already the requested one.
Errors
| Status | Code | When 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
/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_idstring RequiredPublic ID of the launch.Example101482937561204
Returns 200 OK · application/json
-
tokenstringDividend token. -
symbolstring | nullSymbol. -
decimalsinteger | nullDecimals. -
total_atomicstringTotal held, in base units. -
total_nativestring | nullTotal value in the chain's native token, in base units (lamports or wei). -
total_usdstring | nullTotal value in micro-USD (millionths of a dollar). -
assetsarray<object>One entry per dividend token, with the same fields. Solana answers only this list; EVM answers one entry beside the flat fields.
Errors
| Status | Code | When 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
/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
statusinresults.
Path parameters
-
launch_idstring RequiredPublic ID of the launch.Example101482937561204
Body parameters application/json
-
walletsarray<string> OptionalWallets to sell from. Omit for all. -
slippage_bpsinteger OptionalSlippage tolerance, in basis points. Defaults to 50 on Solana.
Returns 200 OK · application/json
-
okbooleantruewhen the request succeeded. -
resultsarray<object>One result per wallet and token.Child attributes 6
-
walletstringWallet. -
tokenstringToken handled. -
statusenumOutcome.Possible valuesswappedsoldclaimedskippedfailed -
reasonstringWhy it was skipped or failed. -
amountstringAmount handled, in base units. -
tx_hashstringTransaction hash or signature.
-
Errors
| Status | Code | When 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