Claim Cashback

POST /v1/cashback/claim/execute

Claim Cashback submits one or two server-signed transactions for a managed wallet:

• one Pump bonding-curve cashback claim
• one PumpSwap cashback claim

The selected wallet must be a SolanaLaser-managed wallet because the endpoint signs with that wallet. If wallet is omitted, SolanaLaser uses the default managed wallet for the API key.

Before claiming, SolanaLaser runs the same calculation as Check Cashback. It only submits a claim transaction for a source that currently has a positive claimable amount.

Request

const response = await fetch("https://api.solanalaser.xyz/v1/cashback/claim/execute", {
  method: "POST",
  headers: {
    "content-type": "application/json",
    "x-api-key": "sl_your_key",
  },
  body: JSON.stringify({
    wallet: "MANAGED_WALLET_PUBLIC_KEY",
    claim_bonding_curve: true,
    claim_pumpswap: true,
    confirm: true,
  }),
});

const claim = await response.json();

Request Fields

Field	Type	Required	Meaning
wallet	string	No	Managed wallet public key to claim for. Defaults to the API key's default wallet.
claim_bonding_curve	boolean	No	Defaults to true. Enables Pump bonding-curve cashback claim.
claim_pumpswap	boolean	No	Defaults to true. Enables PumpSwap cashback claim.
confirm	boolean	No	Defaults to true. If true, SolanaLaser waits for each claim transaction confirmation.

At least one claim type must be enabled. If both claim types are enabled but only one has a positive amount, only one transaction is submitted.

Claim Both Sources

Request

const response = await fetch("https://api.solanalaser.xyz/v1/cashback/claim/execute", {
  method: "POST",
  headers: {
    "content-type": "application/json",
    "x-api-key": "sl_your_key",
  },
  body: JSON.stringify({
    wallet: "MANAGED_WALLET_PUBLIC_KEY",
    claim_bonding_curve: true,
    claim_pumpswap: true,
  }),
});

const claim = await response.json();

Response: 200

{
  "wallet": "MANAGED_WALLET_PUBLIC_KEY",
  "transactions": [
    {
      "kind": "bonding_curve",
      "claimable_lamports": 1000000,
      "signature": "BONDING_CURVE_CLAIM_SIGNATURE",
      "confirmed": true,
      "confirmation_status": "confirmed"
    },
    {
      "kind": "pumpswap",
      "claimable_lamports": 2500000,
      "signature": "PUMPSWAP_CLAIM_SIGNATURE",
      "confirmed": true,
      "confirmation_status": "confirmed"
    }
  ]
}

Claim PumpSwap Only

Use this when you only want to claim PumpSwap cashback.

Request

const response = await fetch("https://api.solanalaser.xyz/v1/cashback/claim/execute", {
  method: "POST",
  headers: {
    "content-type": "application/json",
    "x-api-key": "sl_your_key",
  },
  body: JSON.stringify({
    wallet: "MANAGED_WALLET_PUBLIC_KEY",
    claim_bonding_curve: false,
    claim_pumpswap: true,
    confirm: false,
  }),
});

const claim = await response.json();

Response: 200

{
  "wallet": "MANAGED_WALLET_PUBLIC_KEY",
  "transactions": [
    {
      "kind": "pumpswap",
      "claimable_lamports": 2500000,
      "signature": "PUMPSWAP_CLAIM_SIGNATURE",
      "confirmed": false,
      "confirmation_status": null
    }
  ]
}

No Claimable Cashback

If the selected claim types are enabled but no source has a positive claimable amount, the endpoint returns an empty transaction list.

Response: 200

{
  "wallet": "MANAGED_WALLET_PUBLIC_KEY",
  "transactions": []
}

PumpSwap WSOL ATA

PumpSwap cashback is paid as WSOL. When claiming PumpSwap cashback, SolanaLaser adds an idempotent instruction to create the wallet's WSOL associated token account if it does not already exist.

That can require rent from the managed wallet. The managed wallet also pays the transaction fee, priority fee, and Sender tip.

Response Fields

Field	Meaning
wallet	Managed wallet that claimed cashback.
transactions	Claim transactions submitted by the endpoint. Empty when nothing was claimable.
transactions.kind	bonding_curve or pumpswap.
transactions.claimable_lamports	Amount that was claimable before submitting this transaction.
transactions.signature	Submitted Solana transaction signature.
transactions.confirmed	true when confirmation polling observed the transaction.
transactions.confirmation_status	RPC status such as processed, confirmed, or finalized; null when confirm: false.

Common Errors

HTTP	Detail	Meaning
400	at least one claim type must be enabled	Both claim_bonding_curve and claim_pumpswap were false.
400	managed wallet selection error	wallet is not attached to this API key.
502	cashback RPC read failed	Pre-claim cashback check failed.
502	Sender or RPC detail	Upstream RPC, Sender, or confirmation failed.

Notes

• Claims are not bundled. If both sources are claimable, SolanaLaser submits one transaction per source.
• confirm: false returns after submission, so confirmed is false and confirmation_status is null.
• A claim amount can change between check and claim if another transaction claims or modifies the same accumulator first.
• Use Check Cashback before claim when you want to preview amounts across many wallets.