Skip to main content
Claim cashback rewards from PumpFun cashback-enabled tokens
POST/pumpfun/claim-cashback
Claim the SOL cashback accumulated from your trades on cashback-enabled PumpFun tokens. Submit one or multiple wallets in a single request — cashback is proportional to each wallet’s swap volume.

​
Quick Start

curl -X POST https://api.launchpad.trade/pumpfun/claim-cashback \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tokenAddress": "7GCihgDB8fe6KNjn2MYtkzZcRjQy3t9GHdC8uHYmW2hr",
    "privateKeys": ["YOUR_PRIVATE_KEY"]
  }'

​
Parameters

ParameterTypeDescription
tokenAddressstringSolana address of the PumpFun token. Must have cashback enabled (isCashback: true at creation)
privateKeysstring[]Private keys of the wallets claiming cashback. 1–50 wallets per request

​
What Is Cashback?

When a token is created with isCashback: true, the standard 0.3% creator fees are redirected to traders instead of the token creator. Each trader accumulates cashback proportional to their swap volume on that token.
  • Accumulated — cashback builds up with every trade until claimed
  • Proportional — the more you trade, the more you accumulate
  • Repeatable — claim as often as you want, whenever new cashback is available
  • No admin required — any trader who has traded the token can claim
Only tokens created with isCashback: true generate cashback. Standard tokens (creator fees paid to creator) use Claim Creator Fees instead.

​
Response

{
  "success": true,
  "data": {
    "tokenAddress": "7GCihgDB8fe6KNjn2MYtkzZcRjQy3t9GHdC8uHYmW2hr",
    "claims": [
      {
        "wallet": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
        "signature": "5UfDuX7nPqR3kLm8vYz...",
        "slot": 234567890,
        "latency": 670,
        "amountClaimed": 0.0542,
        "status": "SUCCESS"
      },
      {
        "wallet": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
        "signature": "3KmPqY8nPqR3kLm8vYz...",
        "slot": 234567891,
        "latency": 720,
        "amountClaimed": 0.0128,
        "status": "SUCCESS"
      }
    ],
    "summary": {
      "totalWallets": 2,
      "successCount": 2,
      "failedCount": 0,
      "nothingToClaimCount": 0,
      "totalCashbackClaimed": 0.067
    }
  }
}

​
Per-Wallet Fields

FieldTypeDescription
walletstringPublic address of the wallet
signaturestring | nullTransaction signature. null if nothing to claim
slotnumber | nullSlot the transaction landed in. null if nothing to claim
latencynumber | nullTotal time from request to Solana confirmation (ms)
amountClaimednumberSOL amount claimed. 0 if nothing to claim
statusstringSUCCESS, NOTHING_TO_CLAIM, or FAILED
errorstring | nullError message if FAILED

​
Summary Fields

FieldTypeDescription
totalWalletsnumberTotal wallets in the request
successCountnumberWallets that claimed successfully
failedCountnumberWallets that failed
nothingToClaimCountnumberWallets with no cashback to claim
totalCashbackClaimednumberTotal SOL claimed across all wallets

​
Errors

{
  "success": false,
  "error": {
    "code": "NOT_CASHBACK_TOKEN",
    "message": "Token does not have cashback enabled"
  }
}
CodeMessageCause
INVALID_TOKENInvalid token addressToken address is not a valid Solana address
NOT_CASHBACK_TOKENToken does not have cashback enabledToken was not created with isCashback: true
NO_WALLETSNo wallets providedprivateKeys array is empty
TOO_MANY_WALLETSMaximum 50 wallets per requestMore than 50 wallets submitted
RATE_LIMITRate limit exceededToo many requests — see Rate Limits
INTERNAL_ERRORInternal server errorRetry or contact support

​
Cashback vs Creator Fees

Claim Creator FeesClaim Cashback
Who claimsCreator / fee recipientsTraders
Fee source0.3% creator fees0.3% redirected via cashback
ConditionWallet is a registered fee recipientWallet has traded the token
Multi-wallet1 wallet per request1–50 wallets per request
Token requirementAny PumpFun tokenToken with isCashback: true
Proportional toConfigured share percentageSwap volume

​
Notes

Claims are processed in parallel across all wallets. Submit multiple wallets in a single request to minimize round trips.
  • Claiming is free — you only pay the standard Solana transaction fee per wallet
  • A wallet with no trading activity or already-claimed cashback returns NOTHING_TO_CLAIM

​
What’s Next?

Claim Creator Fees

Claim your creator fees from a PumpFun token

Create Token

Deploy a cashback-enabled token on PumpFun

Update Fee Shares

Configure fee recipients and percentages

Instant Buy

Buy tokens to accumulate cashback