Skip to main content
Burn unwanted tokens and recover rent SOL with Launchpad Trade API
POST/utilities/burn
Remove unwanted tokens from one or multiple wallets by sending them to a burn address. In ALL mode, the token account is also closed and its rent SOL (~0.002 SOL) is returned to the wallet owner.

​
Quick Start

curl -X POST https://api.launchpad.trade/utilities/burn \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "privateKeys": ["YOUR_PRIVATE_KEY"],
    "mints": ["TOKEN_MINT_ADDRESS"],
    "amount": {
      "mode": "ALL"
    }
  }'

​
Parameters

ParameterTypeDescription
privateKeysstring[]Private keys of the wallets to process. Min 1, max 50
mintsstring[]Token mint addresses to burn. Min 1, max 20
amountobjectAmount configuration. See Amount Modes below

​
amount

PropertyTypeDescription
modestringALL or AMOUNT
valuenumberNumber of tokens to burn in human-readable units (e.g., 100 for 100 USDC). Required when mode is AMOUNT
Burning is irreversible. Tokens are permanently destroyed and cannot be recovered.

​
Amount Modes

Burn the entire balance and close the token account to recover rent SOL.
{
  "privateKeys": ["5K7gT...", "3Jd8f..."],
  "mints": ["7GCihgDB8fe6KNjn2MYtkzZcRjQy3t9GHdC8uHYmW2hr"],
  "amount": {
    "mode": "ALL"
  }
}
Flow: burn all tokens → balance reaches zero → account closed → ~0.002 SOL rent returned to wallet.

​
Use Cases

ScenarioApproach
Remove airdropped spam tokensUse ALL mode to burn and close the accounts in one step
Reduce circulating supplyUse AMOUNT mode to burn a specific quantity
Clean up after sellingUse ALL mode with the sold token’s mint to recover rent
Partial burn across walletsUse AMOUNT mode with multiple privateKeys
With ALL mode, there is no need to call Close Accounts separately — burning and closing happen in a single operation.

​
Response

{
  "success": true,
  "data": {
    "burns": [
      {
        "wallet": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
        "mint": "7GCihgDB8fe6KNjn2MYtkzZcRjQy3t9GHdC8uHYmW2hr",
        "symbol": "MYTOKEN",
        "amountBurned": 71118058643,
        "amountBurnedFormatted": "71118.058643",
        "status": "SUCCESS",
        "signature": "5GS8Kh9g5qhRXSQEwmdcYKV32WZRULY2LQTaMVmUQEWQpDvmQkh4g2Wrqd1ab2LAzKwC79rG6iRD6LG7rmFcgA6Q",
        "accountClosed": true,
        "rentRecovered": 0.00203928
      }
    ],
    "summary": {
      "totalWallets": 1,
      "totalMints": 1,
      "successCount": 1,
      "failedCount": 0,
      "totalBurned": 71118058643,
      "totalBurnedFormatted": "71118.058643",
      "totalAccountsClosed": 1,
      "totalRentRecovered": 0.00203928
    },
    "latency": 680
  }
}

​
Partial Success

Some burns may fail individually while others succeed. The response still returns "success": true with per-wallet details. Failed burns have status: "FAILED", an error field with the reason, and an errorCode field with the error code. When failures occur, a warnings array is included at the root of the response: 
{
  "success": true,
  "data": { ... },
  "warnings": ["2 burn(s) failed"]
}
When all burns fail, the response returns "success": false with both an error object and the data object containing per-wallet details.
Each burn is independent. There is no atomic guarantee — check the status field for each entry.

​
Errors

{
  "success": false,
  "error": {
    "code": "INSUFFICIENT_BALANCE",
    "message": "Wallet 7xKX... has insufficient balance for token 7GCi..."
  }
}
CodeMessageCause
INVALID_WALLETInvalid private keyOne of the private keys is invalid
INVALID_MINTInvalid mint addressOne of the mint addresses is invalid
NO_WALLETSNo wallets providedNo private keys provided
NO_MINTSNo mints providedNo mint addresses provided
TOO_MANY_WALLETSMaximum 50 wallets per requestMore than 50 wallets submitted
TOO_MANY_MINTSMaximum 20 mints per requestMore than 20 mints submitted
NO_BALANCENo balance for tokenWallet does not hold the specified token
INSUFFICIENT_BALANCEInsufficient balanceNot enough tokens for the requested AMOUNT
INVALID_AMOUNTInvalid amountAmount value is missing or invalid
RATE_LIMITRate limit exceededToo many requests — see Rate Limits
INTERNAL_ERRORInternal server errorRetry or contact support

​
Notes

  • Maximum 50 wallets and 20 mints per request
  • In ALL mode, the token account is closed and rent SOL is recovered automatically
  • Each wallet pays its own Solana transaction fee
  • Per-burn fields amountBurned, amountBurnedFormatted, accountClosed, and rentRecovered are only present on successful burns — they are omitted on failed entries

​
What’s Next?

Close Accounts

Close empty token accounts and reclaim rent SOL

Token Info

List token accounts and check balances

Sell Tokens

Sell tokens before burning their accounts

Withdraw SOL

Consolidate SOL after cleanup