# 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](/reference/launches/#object-launch) object reports `creator_fees` and `unclaimed_cashback`.

Base URL: `https://api-mig.proxima.tools`

## Endpoints

- `POST /launch/collect-fees/{launch_id}`: Collect creator fees
- `POST /launch/pumpfun/claim-cashback/{launch_id}`: Claim pump.fun cashback
- `POST /launch/pumpfun/update-fee-shares/{launch_id}`: Update pump.fun fee shares
- `GET /launch/fee-recipient/{launch_id}`: Retrieve the fee recipient
- `POST /launch/fee-recipient/{launch_id}`: Set the fee recipient
- `GET /launch/dividends/{launch_id}`: Retrieve dividends
- `POST /launch/sell-dividends/{launch_id}`: Sell dividends

### Collect creator fees

`POST /launch/collect-fees/{launch_id}`

Claims the creator fees the launch has earned. (Bearer JWT)

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

> A refusal can come back as 200 with `ok: false` and a `message`; the SDK turns it into an error.

#### Path parameters

- `launch_id` (string, required): Public ID of the launch.

#### Returns 200 OK

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

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 400 | `bad_request` | `invalid launch id format` | `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](/reference/licenses/#list-mints). |
| 400 | `bad_request` | `collect-fees not supported for platform <platform>` | 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` | `token not launched` | 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 to the account it custodies for your api key, so they are claimed from anoncoin rather than from here` | Anoncoin pays this launch's creator fees into an account it keeps for your API key. | Claim these fees from Anoncoin. |
| 400 | `bad_request` | `this launch holds no position (imported pools are not ours)` | 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` | `no fees to collect` | 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` | `launch 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` | `Cannot claim fees on imported launch` | 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` | `Pumpfun distributes these rewards to holders; the creator cannot claim or redirect them` | 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` | `<partner> takes the whole creator fee stream, this launch earns none` | 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` | `The curve pays its creator <address>, which is not this launch's dev wallet` | 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](/reference/launches/#retrieve-launch). |
| 409 | `conflict` | `a claim is already running on this launch, wait for it to land` | 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` | `No fees to claim` | 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` | `Dev wallet needs at least 0.01 SOL to claim creator rewards` | 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` | `nothing prices this launch's quote right now, the claim cannot be valued` | 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` | `tx_engine api issue: <detail>` | 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` | `Token not launched` | On Solana, the launch has not been deployed yet. | Wait until the launch is deployed, then call again. |

#### Example request

```bash
curl -X POST "https://api-mig.proxima.tools/launch/collect-fees/101482937561204" \
  -H "Authorization: Bearer $PROXIMA_JWT"
```

#### Example response

```json
{
  "ok": true,
  "tx_hash": "0xbf464b78fce614b8966ba8ec73e25795f0c475aa2247fe43f71a2bc500dc774b",
  "fee_received": "184203117000000000"
}
```

### Claim pump.fun cashback

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

Claims the pump.fun cashback the launch has accumulated. (Bearer JWT)

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

#### Returns 200 OK

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

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 400 | `bad_request` | `invalid launch id format` | `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](/reference/licenses/#list-mints). |
| 400 | `unsupported_chain` | `this endpoint is not supported for this chain` | The launch is on an EVM chain. | Call this endpoint only for Solana launches. |
| 400 | `bad_request` | `Cashback only available for pumpfun launches` | The launch is not on pump.fun. | Claim cashback only on pump.fun launches. |
| 404 | `not_found` | `launch 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` | `Cashback not enabled for this launch` | The token was created without pump.fun cashback. | Claim cashback only on tokens created with cashback enabled. |
| 409 | `conflict` | `Launch must be deployed to claim cashback` | The launch's deploy has not finished. | Wait until the deploy finishes, then call again. |
| 422 | `unprocessable` | `No unclaimed cashback` | None of the launch's wallets has cashback left to claim. | Call again after the wallets have traded more. |
| 422 | `unprocessable` | `Funder has insufficient SOL (min 0.1 SOL required)` | The funder pays the claim fees and holds less than 0.1 SOL. | Top up the launch's funder, listed by [List funders](/reference/funders/#list-funders), then call again. |
| 422 | `upstream_failure` | `tx_engine api issue: Error while claiming cashback` | At least one claim transaction did not land; the others may have. | Call again: it claims only the cashback still unclaimed. |
| 500 | `internal_error` | `Token not launched` | The launch has not been deployed yet. | Wait until the launch is deployed, then call again. |

#### Example request

```bash
curl -X POST "https://api-mig.proxima.tools/launch/pumpfun/claim-cashback/101482937561204" \
  -H "Authorization: Bearer $PROXIMA_JWT"
```

#### Example response

```json
{
  "ok": true,
  "message": "Successfully claimed cashback",
  "amount": 48120000
}
```

### Update pump.fun fee shares

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

Changes how the creator fees of a live pump.fun token are split. (Bearer JWT)

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

> Each leg names exactly one of `address`, `github` or `charity_id`.

> Solana pump.fun launches only.

#### Path parameters

- `launch_id` (string, required): Public ID of the launch.

#### Body parameters

- `new_shares` (array<object>, required): The new split. Shares must add up to 10000.
  - `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

- `ok` (boolean): `true` when the request succeeded.
- `message` (string): Human-readable outcome.

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 400 | `bad_request` | `invalid launch id format` | `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](/reference/licenses/#list-mints). |
| 400 | `unsupported_chain` | `this endpoint is not supported for this chain` | The launch is on an EVM chain. | Call this endpoint only for Solana launches. |
| 400 | `bad_request` | `Fee shares must sum to 10000 (bps)` | `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` | `The dev can no longer change these fee shares` | 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` | `launch 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` | `Cannot update fees on imported launch` | 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` | `pumpfun api issue: Failed to aggregate charity config` | pump.fun couldn't resolve a charity leg. | Check each `charity_id`, then call again. |
| 422 | `upstream_failure` | `tx_engine api issue: Error while updating fee shares` | The update transaction did not land. | Call again with the same split. |
| 500 | `internal_error` | `Token not launched` | The launch has not been deployed yet. | Wait until the launch is deployed, then call again. |

#### Example request

```bash
curl -X POST "https://api-mig.proxima.tools/launch/pumpfun/update-fee-shares/101482937561204" \
  -H "Authorization: Bearer $PROXIMA_JWT" \
  -H "Content-Type: application/json" \
  -d '{
  "new_shares": [
    {
      "address": "BZJTwe2bzzTQBwy5VQwwrhbzbMUbQoBZ59F9g3fUUtZU",
      "share_bps": 7000
    },
    {
      "github": "orbitcat-dev",
      "share_bps": 3000
    }
  ]
}'
```

#### Example response

```json
{
  "ok": true,
  "message": "Successfully updated pump fee shares"
}
```

### Retrieve the fee recipient

`GET /launch/fee-recipient/{launch_id}`

Returns where the launch's creator fees go today. (Bearer JWT)

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

> EVM launches on Pons, Pons v2, Znipe, Foci, Lift or Long. The app uses it for Pons and Foci.

#### Path parameters

- `launch_id` (string, required): Public ID of the launch.

#### Returns 200 OK

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

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 400 | `bad_request` | `invalid launch id format` | `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](/reference/licenses/#list-mints). |
| 400 | `unsupported_chain` | `this endpoint is not supported for this chain` | The launch is on Solana. | Call this endpoint only for EVM launches. |
| 400 | `bad_request` | `token not launched` | The launch has not been deployed yet. | Wait until the launch is deployed, then call again. |
| 400 | `bad_request` | `<platform> does not expose a creator fee recipient` | 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` | `launch 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. |

#### Example request

```bash
curl "https://api-mig.proxima.tools/launch/fee-recipient/101482937561204" \
  -H "Authorization: Bearer $PROXIMA_JWT"
```

#### Example response

```json
{
  "ok": true,
  "recipient": "0xab2b93519e1fbc3bfc0e79f066f6b11af5d97d9c",
  "tx_hashes": [],
  "can_change": true
}
```

### Set the fee recipient

`POST /launch/fee-recipient/{launch_id}`

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

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

> EVM launches on Pons, Pons v2, Znipe or Long; only Pons v2 and Znipe take a `holders` target.

#### Path parameters

- `launch_id` (string, required): Public ID of the launch.

#### Body parameters

- `target` (object, required): New recipient.
  - `kind` (enum, required): Who receives the fees. Possible values: `dev`, `wallet`, `holders`.
  - `address` (string, optional): Wallet to pay. Required when `kind` is `wallet`.

#### Returns 200 OK

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

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 400 | `bad_request` | `invalid launch id format` | `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](/reference/licenses/#list-mints). |
| 400 | `unsupported_chain` | `this endpoint is not supported for this chain` | The launch is on Solana. | Call this endpoint only for EVM launches. |
| 400 | `bad_request` | `a wallet target needs an `address`` | `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` | `token not launched` | The launch has not been deployed yet. | Wait until the launch is deployed, then call again. |
| 400 | `bad_request` | `<platform> cannot move its creator fees` | 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` | `this launch shares its creator fees with its holders; <address> pays them out and cannot hand them back` | 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` | `this launch's creator fees are controlled by <address>, which is not a wallet on this license` | 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` | `launch 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 holds this launch's creator fee recipient` | UsePaid controls where this launch's creator fees go. | Change the recipient through UsePaid. |
| 422 | `unprocessable` | `dev wallet <address> has insufficient native balance to pay gas; fund it and retry` | The dev wallet can't pay the gas. | Fund the dev wallet, then call again. |
| 422 | `unprocessable` | `this launch still pays its creator fees to <address>` | The change was sent, but a chain read still shows the old recipient. | Read it back with [Retrieve the fee recipient](/reference/launch-fees/#retrieve-fee-recipient), and call again if it hasn't changed. |
| 422 | `upstream_failure` | `evm_tx_engine api issue: <detail>` | The transaction failed or did not land. | Call again: once the recipient is set, a repeat sends nothing. |

#### Example request

```bash
curl -X POST "https://api-mig.proxima.tools/launch/fee-recipient/101482937561204" \
  -H "Authorization: Bearer $PROXIMA_JWT" \
  -H "Content-Type: application/json" \
  -d '{
  "target": {
    "kind": "wallet",
    "address": "0x8627fb3110f34ad0e7b7be160fba95f0b0c4022a"
  }
}'
```

#### Example response

```json
{
  "ok": true,
  "recipient": "0x8627fb3110f34ad0e7b7be160fba95f0b0c4022a",
  "tx_hashes": [
    "0x99d1712689894d446aa4115fef4bb10f325c7a6f0b75853c573cda1ac1a3f350"
  ],
  "can_change": true,
  "already_set": false
}
```

### Retrieve dividends

`GET /launch/dividends/{launch_id}`

Returns the dividends the launch wallets hold. (Bearer JWT)

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

#### Returns 200 OK

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

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 400 | `bad_request` | `invalid launch id format` | `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](/reference/licenses/#list-mints). |
| 400 | `bad_request` | `token not launched` | On EVM, the launch has not been deployed yet. | Wait until the launch is deployed, then call again. |
| 404 | `not_found` | `launch 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` | `this launch pays no dividend` | 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` | `this launch is paid in its own coin, sell it through nuke` | The dividend is the launch's own token. | Sell it with [Nuke a launch](/reference/launch-trading/#nuke). |
| 422 | `unprocessable` | `dividends are already in the gas token` | 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](/reference/wallets/#list-wallets). |
| 422 | `unprocessable` | `Otcdesks pair rewards share the trading quote balance; manage them through quote balances` | 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` | `no dividend held on this launch's wallets` | None of the launch's wallets holds any dividend right now. | Call again once dividends have accrued. |
| 500 | `internal_error` | `Token not launched` | On Solana, the launch has not been deployed yet. | Wait until the launch is deployed, then call again. |

#### Example request

```bash
curl "https://api-mig.proxima.tools/launch/dividends/101482937561204" \
  -H "Authorization: Bearer $PROXIMA_JWT"
```

#### Example response

```json
{
  "assets": [
    {
      "token": "2jJhjeLE7KA64hNmGp5pwvb7cySPnTnFxvDuzMXyyirB",
      "symbol": "NVDAx",
      "decimals": 8,
      "total_atomic": "412500000",
      "total_native": "3218000000",
      "total_usd": "580440000"
    }
  ]
}
```

### Sell dividends

`POST /launch/sell-dividends/{launch_id}`

Sells the dividends held by the launch wallets. (Bearer JWT)

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

#### Body parameters

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

- `ok` (boolean): `true` when the request succeeded.
- `results` (array<object>): One result per wallet and token.
  - `wallet` (string): Wallet.
  - `token` (string): Token handled.
  - `status` (enum): Outcome. Possible values: `swapped`, `sold`, `claimed`, `skipped`, `failed`.
  - `reason` (string): Why it was skipped or failed.
  - `amount` (string): Amount handled, in base units.
  - `tx_hash` (string): Transaction hash or signature.

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 400 | `bad_request` | `invalid launch id format` | `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](/reference/licenses/#list-mints). |
| 400 | `bad_request` | `invalid wallet address` | 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](/reference/wallets/#list-wallets). |
| 400 | `bad_request` | `token not launched` | On EVM, the launch has not been deployed yet. | Wait until the launch is deployed, then call again. |
| 404 | `not_found` | `launch 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` | `wallet <address> not in launch` | 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](/reference/wallets/#list-wallets). |
| 422 | `unprocessable` | `no wallets named` | `wallets` is an empty list. | Omit `wallets` to sell from every launch wallet. |
| 422 | `unprocessable` | `this launch pays no dividend` | 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` | `this launch is paid in its own coin, sell it through nuke` | The dividend is the launch's own token. | Sell it with [Nuke a launch](/reference/launch-trading/#nuke). |
| 422 | `unprocessable` | `dividends are already in the gas token` | 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](/reference/wallets/#list-wallets). |
| 422 | `unprocessable` | `Otcdesks pair rewards share the trading quote balance; manage them through quote balances` | 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` | `no dividend held on this launch's wallets` | 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` | `Token not launched` | On Solana, the launch has not been deployed yet. | Wait until the launch is deployed, then call again. |

#### Example request

```bash
curl -X POST "https://api-mig.proxima.tools/launch/sell-dividends/101482937561204" \
  -H "Authorization: Bearer $PROXIMA_JWT" \
  -H "Content-Type: application/json" \
  -d '{
  "slippage_bps": 100
}'
```

#### Example response

```json
{
  "ok": true,
  "results": [
    {
      "wallet": "HBwqDp7Qpmzos1wZhr5ZpwfsedZFGHubfdibhHBeH47Z",
      "token": "2jJhjeLE7KA64hNmGp5pwvb7cySPnTnFxvDuzMXyyirB",
      "status": "sold",
      "amount": "206250000",
      "tx_hash": "2bvqLBp2kyWxAuJnvJ2ZnffCHUWEPW3XoJthATsJNozs7ryhPgC9pALXNnL1jH1TsGQ63kG1MtN6t6vLeNGu5uGE"
    },
    {
      "wallet": "GwjXHJRZCrZjmRTzfuBCFkeuMmy6PxNMET4cPSmsvahJ",
      "token": "2jJhjeLE7KA64hNmGp5pwvb7cySPnTnFxvDuzMXyyirB",
      "status": "skipped",
      "reason": "Nothing to sell"
    }
  ]
}
```
