API Documentation (v2)

Quick Start

Two common operations to get started. Each returns base58-encoded serialized transactions for your wallet to sign and send.

Build a Burn Transaction

Burns a token, NFT, or closes a token account. Returns a single serialized transaction ready for signing.

cURL

bash

curl -X POST 'https://v2.api.sol-incinerator.com/burn' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY' \
  -d '{
    "userPublicKey": "YOUR_WALLET_PUBKEY",
    "assetId": "ASSET_MINT_OR_ACCOUNT"
  }'

TypeScript

typescript

const res = await fetch("https://v2.api.sol-incinerator.com/burn", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "x-api-key": process.env.BURN_API_KEY!,
  },
  body: JSON.stringify({ userPublicKey, assetId }),
});

const { serializedTransaction } = await res.json();

// Deserialize and sign locally
const tx = VersionedTransaction.deserialize(
  bs58.decode(serializedTransaction),
);
tx.sign([userKeypair]);

// Relay through API
const relay = await fetch("https://v2.api.sol-incinerator.com/transactions/send", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "x-api-key": process.env.BURN_API_KEY!,
  },
  body: JSON.stringify({
    signedTransaction: bs58.encode(tx.serialize()),
    waitForConfirmation: true,
  }),
});

const { signature } = await relay.json();

Response

json

{
  "assetId": "7xKXtg2CW...",
  "serializedTransaction": "AQAAAA...",
  "lamportsReclaimed": 1998495,
  "solanaReclaimed": 0.001998495,
  "transactionType": "TOKEN_BURN",
  "isDestructiveAction": true
}

Run Unified Cleanup

Reclaim rent from empty token accounts and close eligible Pump.fun/PumpSwap accumulators in one call. This is the recommended non-destructive cleanup path for wallet integrations.

cURL

bash

curl -X POST 'https://v2.api.sol-incinerator.com/cleanup/all' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY' \
  -d '{
    "userPublicKey": "YOUR_WALLET_PUBKEY"
  }'

TypeScript

typescript

const res = await fetch("https://v2.api.sol-incinerator.com/cleanup/all", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "x-api-key": process.env.BURN_API_KEY!,
  },
  body: JSON.stringify({ userPublicKey }),
});

const { transactions } = await res.json();

// Sign transactions locally
const signedTransactions: string[] = [];
for (const raw of transactions) {
  const tx = VersionedTransaction.deserialize(
    bs58.decode(raw),
  );
  tx.sign([userKeypair]);
  signedTransactions.push(bs58.encode(tx.serialize()));
}

// Relay them in parallel through API
await fetch("https://v2.api.sol-incinerator.com/transactions/send-batch", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "x-api-key": process.env.BURN_API_KEY!,
  },
  body: JSON.stringify({
    signedTransactions,
    maxConcurrency: 4,
  }),
});

Response

json

{
  "transactions": ["AQAAAA...", "BQAAAA..."],
  "accountsClosed": 4,
  "totalLamportsReclaimed": 7612014,
  "nativeSolLamportsReclaimed": 7612014,
  "wrappedCashbackLamportsRetained": 0,
  "nativeSolCostLamports": 2039280,
  "netNativeSolLamportsChange": 5572734,
  "tokenRewards": [
    {
      "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "tokenProgram": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
      "symbol": "USDC",
      "decimals": 6,
      "grossAmountRaw": "2512562",
      "feeAmountRaw": "12562",
      "feeBps": 50,
      "amountRaw": "2500000",
      "uiAmount": 2.5,
      "destinationTokenAccount": "...",
      "destinationTokenAccountExists": false,
      "nativeSolCostLamports": 2039280
    }
  ],
  "totalSolanaReclaimed": 0.007612014,
  "hasDestructiveActions": false,
  "breakdown": {
    "emptyTokenAccounts": 2,
    "pumpAccumulators": 2
  },
  "totalAccountsFound": 2,
  "truncated": false
}

Authentication

Core burn, close, batch, and transaction relay endpoints require x-api-key (or Authorization bearer). Public routes include GET /, POST /api-keys/generate, and discovery/docs endpoints like /openapi.json. MCP OAuth metadata/endpoints are also public (/.well-known/oauth-*, /register, /oauth/authorize, /oauth/token).

Required Header

http

x-api-key: YOUR_API_KEY

Burn Endpoints

Burn tokens and NFTs. Supports SPL tokens, Token-2022, Metaplex NFTs, editions, pNFTs, and MPL Core assets.

POST/burn

Build a serialized burn transaction for the user to sign and send.

Parameter	Type	Required	Default	Description
userPublicKey	string (base58)	Yes	-	The wallet public key of the user initiating the action.
assetId	string (base58)	Yes	-	Mint address or token account address. For mint input, the API resolves to exactly one owned token account when required.
feePayer	string (base58)	No	userPublicKey	Public key of the account that pays transaction fees. Defaults to the userPublicKey when omitted.
autoCloseTokenAccounts	boolean	No	true	When true, automatically closes eligible associated token accounts after burning or selling, reclaiming their rent.
priorityFeeMicroLamports	integer	No	auto-estimated	Priority fee in micro-lamports to include with the transaction. When omitted the API auto-estimates an appropriate value.
asLegacyTransaction	boolean	No	false	When true, returns a legacy transaction instead of a versioned (v0) transaction.
burnAmount	string \| number	No	all tokens	The amount of tokens to burn. When omitted, the entire token balance is burned.
partnerFeeAccount	string (base58)	No	-	Public key of the partner account that receives a share of the reclaimed SOL. Must be provided together with partnerFeeBps.
partnerFeeBps	integer (0-9800)	No	-	Fee share in basis points (0-9800) directed to the partnerFeeAccount. Must be provided together with partnerFeeAccount.
referralCode	string	No	-	2-20 lowercase alphanumeric characters. Accepted on all core burn/sell/close POST endpoints (including preview/summary where available). Referrers receive 20% of future protocol fees from referred wallets for life. If a wallet already used another referral code, the API will not reassign it. Create and claim rewards at https://sol-incinerator.com/rewards. Mutually exclusive with partnerFeeAccount/partnerFeeBps.

cURL

bash

curl -X POST 'https://v2.api.sol-incinerator.com/burn' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY' \
  -d '{
    "userPublicKey": "YOUR_WALLET_PUBKEY",
    "assetId": "ASSET_MINT_OR_TOKEN_ACCOUNT"
  }'

TypeScript

typescript

const res = await fetch("https://v2.api.sol-incinerator.com/burn", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "x-api-key": process.env.BURN_API_KEY!,
  },
  body: JSON.stringify({ userPublicKey, assetId }),
});

const { serializedTransaction } = await res.json();

// Deserialize, sign, and send
const tx = VersionedTransaction.deserialize(
  bs58.decode(serializedTransaction),
);
tx.sign([userKeypair]);
const sig = await connection.sendTransaction(tx);

Response

json

{
  "assetId": "7xKXtg2CW...",
  "serializedTransaction": "AQAAAA...",
  "lamportsReclaimed": 1998495,
  "solanaReclaimed": 0.001998495,
  "transactionType": "TOKEN_BURN",
  "isDestructiveAction": true
}

Field	Type	Description
assetId	string	The asset identifier from the request.
serializedTransaction	string (base58)	Serialized transaction for the user to sign and send.
lamportsReclaimed	integer	Lamports reclaimed from closed token accounts.
solanaReclaimed	number	SOL equivalent of lamportsReclaimed.
transactionType	string	Operation type: TOKEN_BURN, METAPLEX_BURN, TOKEN_2022_BURN, METAPLEX_CORE_BURN, etc.
isDestructiveAction	boolean	True if the operation destroys an asset with potential market value.

POST/burn/preview

Preview fees, reclaim amounts, and asset info before signing a burn transaction.

Parameter	Type	Required	Default	Description
userPublicKey	string (base58)	Yes	-	The wallet public key of the user initiating the action.
assetId	string (base58)	Yes	-	Mint address or token account address. For mint input, the API resolves to exactly one owned token account when required.
feePayer	string (base58)	No	userPublicKey	Public key of the account that pays transaction fees. Defaults to the userPublicKey when omitted.
autoCloseTokenAccounts	boolean	No	true	When true, automatically closes eligible associated token accounts after burning or selling, reclaiming their rent.
priorityFeeMicroLamports	integer	No	auto-estimated	Priority fee in micro-lamports to include with the transaction. When omitted the API auto-estimates an appropriate value.
asLegacyTransaction	boolean	No	false	When true, returns a legacy transaction instead of a versioned (v0) transaction.
burnAmount	string \| number	No	all tokens	The amount of tokens to burn. When omitted, the entire token balance is burned.
partnerFeeAccount	string (base58)	No	-	Public key of the partner account that receives a share of the reclaimed SOL. Must be provided together with partnerFeeBps.
partnerFeeBps	integer (0-9800)	No	-	Fee share in basis points (0-9800) directed to the partnerFeeAccount. Must be provided together with partnerFeeAccount.
referralCode	string	No	-	2-20 lowercase alphanumeric characters. Accepted on all core burn/sell/close POST endpoints (including preview/summary where available). Referrers receive 20% of future protocol fees from referred wallets for life. If a wallet already used another referral code, the API will not reassign it. Create and claim rewards at https://sol-incinerator.com/rewards. Mutually exclusive with partnerFeeAccount/partnerFeeBps.

cURL

bash

curl -X POST 'https://v2.api.sol-incinerator.com/burn/preview' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY' \
  -d '{
    "userPublicKey": "YOUR_WALLET_PUBKEY",
    "assetId": "ASSET_MINT_OR_TOKEN_ACCOUNT"
  }'

TypeScript

typescript

const res = await fetch("https://v2.api.sol-incinerator.com/burn/preview", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "x-api-key": process.env.BURN_API_KEY!,
  },
  body: JSON.stringify({ userPublicKey, assetId }),
});

const preview = await res.json();
console.log(preview.feeBreakdown, preview.lamportsReclaimed);

Response

json

{
  "assetId": "7xKXtg2CW...",
  "transactionType": "TOKEN_BURN",
  "lamportsReclaimed": 1998495,
  "solanaReclaimed": 0.001998495,
  "isDestructiveAction": true,
  "assetInfo": {
    "tokenAccount": "5abc...",
    "mintAddress": "7xKX...",
    "isMetaplexNFT": true,
    "tokenStandard": 0
  },
  "feeBreakdown": {
    "totalFee": 40785,
    "rentReclaimed": { "tokenAccount": 2039280 }
  }
}

Field	Type	Description
assetId	string	The asset identifier from the request.
transactionType	string	Operation type: METAPLEX_BURN, TOKEN_BURN, TOKEN_2022_BURN, etc.
lamportsReclaimed	integer	Estimated lamports to reclaim.
solanaReclaimed	number	SOL equivalent of lamportsReclaimed.
isDestructiveAction	boolean	True if the operation would destroy an asset with potential value.
assetInfo	object	Asset details including tokenAccount, mintAddress, programId, isMetaplexNFT, isProgrammableNFT, tokenStandard, frozen, and tokenBalance.
feeBreakdown	object	Breakdown of fees: totalFee, optional partnerFee, and rentReclaimed per account type (tokenAccount, metadata, edition, tokenRecord).

POST/burn-instructions

Return serialized instruction payloads without building a full transaction.

Parameter	Type	Required	Default	Description
userPublicKey	string (base58)	Yes	-	The wallet public key of the user initiating the action.
assetId	string (base58)	Yes	-	Mint address or token account address. For mint input, the API resolves to exactly one owned token account when required.
autoCloseTokenAccounts	boolean	No	true	When true, automatically closes eligible associated token accounts after burning or selling, reclaiming their rent.
burnAmount	string \| number	No	all tokens	The amount of tokens to burn. When omitted, the entire token balance is burned.
partnerFeeAccount	string (base58)	No	-	Public key of the partner account that receives a share of the reclaimed SOL. Must be provided together with partnerFeeBps.
partnerFeeBps	integer (0-9800)	No	-	Fee share in basis points (0-9800) directed to the partnerFeeAccount. Must be provided together with partnerFeeAccount.
referralCode	string	No	-	2-20 lowercase alphanumeric characters. Accepted on all core burn/sell/close POST endpoints (including preview/summary where available). Referrers receive 20% of future protocol fees from referred wallets for life. If a wallet already used another referral code, the API will not reassign it. Create and claim rewards at https://sol-incinerator.com/rewards. Mutually exclusive with partnerFeeAccount/partnerFeeBps.

cURL

bash

curl -X POST 'https://v2.api.sol-incinerator.com/burn-instructions' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY' \
  -d '{
    "userPublicKey": "YOUR_WALLET_PUBKEY",
    "assetId": "ASSET_MINT_OR_TOKEN_ACCOUNT"
  }'

TypeScript

typescript

const res = await fetch("https://v2.api.sol-incinerator.com/burn-instructions", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "x-api-key": process.env.BURN_API_KEY!,
  },
  body: JSON.stringify({ userPublicKey, assetId }),
});

const { instructions, computeUnitsRequired } = await res.json();

// Add to your own transaction
for (const ix of instructions) {
  transaction.add(deserializeInstruction(ix));
}

Response

json

{
  "assetId": "7xKXtg2CW...",
  "instructions": [
    {
      "programId": "BURNowgY7HVZsFrGo6u7ACfs3wxaThQQdCJhUY4eKtCW",
      "accounts": [
        { "pubkey": "5abc...", "isSigner": false, "isWritable": true }
      ],
      "data": "AQAAAA..."
    }
  ],
  "lamportsReclaimed": 1998495,
  "solanaReclaimed": 0.001998495,
  "instructionType": "TOKEN_BURN",
  "isDestructiveAction": true,
  "computeUnitsRequired": 30000
}

Field	Type	Description
assetId	string	The asset identifier from the request.
instructions	array	Serialized instructions to add to your own transaction.
lamportsReclaimed	integer	Lamports reclaimed from closed accounts.
solanaReclaimed	number	SOL equivalent of lamportsReclaimed.
instructionType	string	Operation type: METAPLEX_BURN, TOKEN_BURN, TOKEN_2022_BURN, etc.
isDestructiveAction	boolean	True if the operation destroys an asset with potential value.
computeUnitsRequired	integer	Estimated compute units needed for the instructions.

Sell Endpoints

Permanently sell illiquid tokens and NFTs for one lamport each. Only canonical associated token accounts are accepted. Eligible source accounts close after transfer, returning rent less the 2% protocol fee and any optional partner fee. The user funds missing destination ATAs and programmable token records up front; source rent offsets that cost later in the transaction. The response reports setup rent and net change before network fees.

POST/sell/batch

Permanently sell tokens or NFTs for one lamport each and close eligible source accounts atomically by default. Recovered source rent pays the 2% protocol fee and any optional partner fee. Missing destination ATAs and programmable token records use the user as rent payer.

Parameter	Type	Required	Default	Description
userPublicKey	string (base58)	Yes	-	The wallet public key of the user initiating the action.
assetIds	string[] (base58)	Yes	-	One to 50 mint or token-account addresses. Source accounts must resolve to the wallet owner's canonical associated token account.
autoCloseTokenAccounts	boolean	No	true	When true, automatically closes eligible associated token accounts after burning or selling, reclaiming their rent.
priorityFeeMicroLamports	integer	No	auto-estimated	Priority fee in micro-lamports to include with the transaction. When omitted the API auto-estimates an appropriate value.
partnerFeeAccount	string (base58)	No	-	Public key of the partner account that receives a share of the reclaimed SOL. Must be provided together with partnerFeeBps.
partnerFeeBps	integer (0-9800)	No	-	Fee share in basis points (0-9800) directed to the partnerFeeAccount. Must be provided together with partnerFeeAccount.
referralCode	string	No	-	2-20 lowercase alphanumeric characters. Accepted on all core burn/sell/close POST endpoints (including preview/summary where available). Referrers receive 20% of future protocol fees from referred wallets for life. If a wallet already used another referral code, the API will not reassign it. Create and claim rewards at https://sol-incinerator.com/rewards. Mutually exclusive with partnerFeeAccount/partnerFeeBps.

cURL

bash

curl -X POST 'https://v2.api.sol-incinerator.com/sell/batch' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY' \
  -d '{
    "userPublicKey": "YOUR_WALLET_PUBKEY",
    "assetIds": ["TOKEN_ACCOUNT_ADDRESS"]
  }'

TypeScript

typescript

const res = await fetch("https://v2.api.sol-incinerator.com/sell/batch", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "x-api-key": process.env.BURN_API_KEY!,
  },
  body: JSON.stringify({
    userPublicKey,
    assetIds: tokenAccountAddresses,
    autoCloseTokenAccounts: true,
    priorityFeeMicroLamports: 100_000,
  }),
});

const { transactions, transactionTargets, rejectedAssets, unclosedSourceAccounts } = await res.json();

// Surface rejections, unclosed source accounts, fees, setup rent, and net change.
// transactionTargets[index] identifies the assets in transactions[index].

Response

json

{
  "transactions": ["AQAAAA..."],
  "transactionTargets": [{
    "assetIds": ["TOKEN_ACCOUNT_ADDRESS"],
    "transactionTypeCounts": { "SELLCINERATOR_TOKEN_SELL": 1 },
    "lamportsReceived": 1,
    "saleProceedsLamports": 1,
    "sourceAccountRentLamports": 2039280,
    "sourceAccountRentReclaimedLamports": 1998495,
    "protocolFeeLamports": 40785,
    "partnerFeeLamports": 0,
    "feeLamports": 40785,
    "destinationAccountRentLamports": 2039280,
    "netLamportsChange": -40784,
    "sourceAccountsClosed": 1,
    "destinationAccountsCreated": 1
  }],
  "rejectedAssets": [],
  "unclosedSourceAccounts": [],
  "assetsProcessed": 1,
  "lamportsReceived": 1,
  "saleProceedsLamports": 1,
  "sourceAccountRentLamports": 2039280,
  "sourceAccountRentReclaimedLamports": 1998495,
  "protocolFeeLamports": 40785,
  "partnerFeeLamports": 0,
  "feeLamports": 40785,
  "destinationAccountRentLamports": 2039280,
  "netLamportsChange": -40784,
  "sourceAccountsClosed": 1,
  "destinationAccountsCreated": 1
}

Field	Type	Description
transactions	string[]	Base58-serialized unsigned transactions.
transactionTargets	object[]	Per-transaction assets and exact sale/rent/fee/setup/net economics, aligned with transactions[].
rejectedAssets	object[]	Assets that cannot be sold, including the rejection reason.
unclosedSourceAccounts	object[]	Successfully sold assets whose source token account remains open, including the reason.
assetsProcessed	integer	Number of assets represented by returned transactions.
lamportsReceived	integer	Compatibility alias for saleProceedsLamports.
saleProceedsLamports	integer	One-lamport sellcinerator payout per processed asset.
sourceAccountRentLamports	integer	Gross rent in source token accounts that will close.
sourceAccountRentReclaimedLamports	integer	Source rent returned after protocol and partner fees.
protocolFeeLamports	integer	2% protocol fee on recovered source-account rent.
partnerFeeLamports	integer	Optional partner fee on recovered source-account rent.
feeLamports	integer	Protocol plus partner fee, excluding network fees.
destinationAccountRentLamports	integer	Expected rent for missing destination ATAs/token records at build time.
netLamportsChange	integer	Expected lamport change before transaction and priority fees; may be negative.
sourceAccountsClosed	integer	Number of source token accounts closed.
destinationAccountsCreated	integer	Number of destination ATAs/token records expected to be created.

Close Endpoints

Close empty or zero-balance token accounts to reclaim rent.

POST/close

Build a close-account transaction to reclaim rent from an empty token account.

Parameter	Type	Required	Default	Description
userPublicKey	string (base58)	Yes	-	The wallet public key of the user initiating the action.
assetId	string (base58)	Yes	-	Token account (preferred) or mint address that resolves to exactly one owned token account.
feePayer	string (base58)	No	userPublicKey	Public key of the account that pays transaction fees. Defaults to the userPublicKey when omitted.
priorityFeeMicroLamports	integer	No	auto-estimated	Priority fee in micro-lamports to include with the transaction. When omitted the API auto-estimates an appropriate value.
asLegacyTransaction	boolean	No	false	When true, returns a legacy transaction instead of a versioned (v0) transaction.
partnerFeeAccount	string (base58)	No	-	Public key of the partner account that receives a share of the reclaimed SOL. Must be provided together with partnerFeeBps.
partnerFeeBps	integer (0-9800)	No	-	Fee share in basis points (0-9800) directed to the partnerFeeAccount. Must be provided together with partnerFeeAccount.
referralCode	string	No	-	2-20 lowercase alphanumeric characters. Accepted on all core burn/sell/close POST endpoints (including preview/summary where available). Referrers receive 20% of future protocol fees from referred wallets for life. If a wallet already used another referral code, the API will not reassign it. Create and claim rewards at https://sol-incinerator.com/rewards. Mutually exclusive with partnerFeeAccount/partnerFeeBps.

cURL

bash

curl -X POST 'https://v2.api.sol-incinerator.com/close' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY' \
  -d '{
    "userPublicKey": "YOUR_WALLET_PUBKEY",
    "assetId": "TOKEN_ACCOUNT_ADDRESS"
  }'

TypeScript

typescript

const res = await fetch("https://v2.api.sol-incinerator.com/close", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "x-api-key": process.env.BURN_API_KEY!,
  },
  body: JSON.stringify({ userPublicKey, assetId: tokenAccountAddress }),
});

const { serializedTransaction } = await res.json();

const tx = VersionedTransaction.deserialize(
  bs58.decode(serializedTransaction),
);
tx.sign([userKeypair]);
await connection.sendTransaction(tx);

Response

json

{
  "assetId": "5abc...",
  "serializedTransaction": "AQAAAA...",
  "lamportsReclaimed": 1998495,
  "solanaReclaimed": 0.001998495,
  "transactionType": "TOKEN_CLOSE",
  "isDestructiveAction": false
}

Field	Type	Description
assetId	string	The token account address from the request.
serializedTransaction	string (base58)	Serialized transaction for the user to sign and send.
lamportsReclaimed	integer	Rent reclaimed from the closed token account.
solanaReclaimed	number	SOL equivalent of lamportsReclaimed.
transactionType	string	TOKEN_CLOSE or TOKEN_2022_CLOSE depending on the token program.
isDestructiveAction	boolean	Always false for close operations.

POST/close/preview

Preview close outcome and fee split before signing.

Parameter	Type	Required	Default	Description
userPublicKey	string (base58)	Yes	-	The wallet public key of the user initiating the action.
assetId	string (base58)	Yes	-	Token account (preferred) or mint address that resolves to exactly one owned token account.
feePayer	string (base58)	No	userPublicKey	Public key of the account that pays transaction fees. Defaults to the userPublicKey when omitted.
priorityFeeMicroLamports	integer	No	auto-estimated	Priority fee in micro-lamports to include with the transaction. When omitted the API auto-estimates an appropriate value.
asLegacyTransaction	boolean	No	false	When true, returns a legacy transaction instead of a versioned (v0) transaction.
partnerFeeAccount	string (base58)	No	-	Public key of the partner account that receives a share of the reclaimed SOL. Must be provided together with partnerFeeBps.
partnerFeeBps	integer (0-9800)	No	-	Fee share in basis points (0-9800) directed to the partnerFeeAccount. Must be provided together with partnerFeeAccount.
referralCode	string	No	-	2-20 lowercase alphanumeric characters. Accepted on all core burn/sell/close POST endpoints (including preview/summary where available). Referrers receive 20% of future protocol fees from referred wallets for life. If a wallet already used another referral code, the API will not reassign it. Create and claim rewards at https://sol-incinerator.com/rewards. Mutually exclusive with partnerFeeAccount/partnerFeeBps.

cURL

bash

curl -X POST 'https://v2.api.sol-incinerator.com/close/preview' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY' \
  -d '{
    "userPublicKey": "YOUR_WALLET_PUBKEY",
    "assetId": "TOKEN_ACCOUNT_ADDRESS"
  }'

TypeScript

typescript

const res = await fetch("https://v2.api.sol-incinerator.com/close/preview", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "x-api-key": process.env.BURN_API_KEY!,
  },
  body: JSON.stringify({ userPublicKey, assetId: tokenAccountAddress }),
});

const preview = await res.json();
console.log(preview.feeBreakdown, preview.lamportsReclaimed);

Response

json

{
  "assetId": "5abc...",
  "transactionType": "TOKEN_CLOSE",
  "lamportsReclaimed": 1998495,
  "solanaReclaimed": 0.001998495,
  "isDestructiveAction": false,
  "assetInfo": {
    "tokenAccount": "5abc...",
    "mintAddress": "7xKX...",
    "programId": "TokenkegQf...",
    "isZeroBalance": true,
    "tokenBalance": "0"
  },
  "feeBreakdown": {
    "totalFee": 40785,
    "rentReclaimed": { "tokenAccount": 2039280 }
  }
}

Field	Type	Description
assetId	string	The token account address from the request.
transactionType	string	TOKEN_CLOSE or TOKEN_2022_CLOSE depending on the token program.
lamportsReclaimed	integer	Estimated rent to reclaim.
solanaReclaimed	number	SOL equivalent of lamportsReclaimed.
isDestructiveAction	boolean	Always false for close operations.
assetInfo	object	Asset details: tokenAccount, mintAddress, programId, isZeroBalance, tokenBalance, frozen.
feeBreakdown	object	Breakdown of fees: totalFee, optional partnerFee, and rentReclaimed.tokenAccount.

POST/close-instructions

Return serialized close-instruction payloads without building a full transaction.

Parameter	Type	Required	Default	Description
userPublicKey	string (base58)	Yes	-	The wallet public key of the user initiating the action.
assetId	string (base58)	Yes	-	Token account (preferred) or mint address that resolves to exactly one owned token account.
partnerFeeAccount	string (base58)	No	-	Public key of the partner account that receives a share of the reclaimed SOL. Must be provided together with partnerFeeBps.
partnerFeeBps	integer (0-9800)	No	-	Fee share in basis points (0-9800) directed to the partnerFeeAccount. Must be provided together with partnerFeeAccount.
referralCode	string	No	-	2-20 lowercase alphanumeric characters. Accepted on all core burn/sell/close POST endpoints (including preview/summary where available). Referrers receive 20% of future protocol fees from referred wallets for life. If a wallet already used another referral code, the API will not reassign it. Create and claim rewards at https://sol-incinerator.com/rewards. Mutually exclusive with partnerFeeAccount/partnerFeeBps.

cURL

bash

curl -X POST 'https://v2.api.sol-incinerator.com/close-instructions' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY' \
  -d '{
    "userPublicKey": "YOUR_WALLET_PUBKEY",
    "assetId": "TOKEN_ACCOUNT_ADDRESS"
  }'

TypeScript

typescript

const res = await fetch("https://v2.api.sol-incinerator.com/close-instructions", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "x-api-key": process.env.BURN_API_KEY!,
  },
  body: JSON.stringify({ userPublicKey, assetId: tokenAccountAddress }),
});

const { instructions } = await res.json();

// Add to your own transaction
for (const ix of instructions) {
  transaction.add(deserializeInstruction(ix));
}

Response

json

{
  "assetId": "5abc...",
  "instructions": [{ "programId": "CLEANALo6FtS6quqTTEXDGFFTuSKMkeKGgcweeiPRJzK", "accounts": [...], "data": "..." }],
  "lamportsReclaimed": 1998495,
  "solanaReclaimed": 0.001998495,
  "instructionType": "TOKEN_CLOSE",
  "isDestructiveAction": false,
  "computeUnitsRequired": 30000
}

Field	Type	Description
assetId	string	The token account address.
instructions	array	Serialized close instructions to add to your own transaction.
lamportsReclaimed	integer	Rent reclaimed from the closed account.
solanaReclaimed	number	SOL equivalent of lamportsReclaimed.
instructionType	string	TOKEN_CLOSE or TOKEN_2022_CLOSE depending on the token program.
isDestructiveAction	boolean	Always false for close operations.
computeUnitsRequired	integer	Estimated compute units needed.

Batch Endpoints

Close all empty accounts for a wallet in one call. Supports pagination via offset/limit.

POST/batch/close-all

Close empty token accounts for a wallet. Returns one or more base58 transactions (or an empty array for preview-only API keys).

Parameter	Type	Required	Default	Description
userPublicKey	string (base58)	Yes	-	The wallet public key of the user initiating the action.
offset	integer (>= 0)	No	0	Number of token accounts to skip before processing. Used for pagination.
limit	integer (1-5000)	No	500	Maximum number of token accounts to include in a single batch. Range: 1-5000.
feePayer	string (base58)	No	userPublicKey	Public key of the account that pays transaction fees. Defaults to the userPublicKey when omitted.
priorityFeeMicroLamports	integer	No	auto-estimated	Priority fee in micro-lamports to include with the transaction. When omitted the API auto-estimates an appropriate value.
asLegacyTransaction	boolean	No	false	When true, returns a legacy transaction instead of a versioned (v0) transaction.
partnerFeeAccount	string (base58)	No	-	Public key of the partner account that receives a share of the reclaimed SOL. Must be provided together with partnerFeeBps.
partnerFeeBps	integer (0-9800)	No	-	Fee share in basis points (0-9800) directed to the partnerFeeAccount. Must be provided together with partnerFeeAccount.
referralCode	string	No	-	2-20 lowercase alphanumeric characters. Accepted on all core burn/sell/close POST endpoints (including preview/summary where available). Referrers receive 20% of future protocol fees from referred wallets for life. If a wallet already used another referral code, the API will not reassign it. Create and claim rewards at https://sol-incinerator.com/rewards. Mutually exclusive with partnerFeeAccount/partnerFeeBps.

cURL

bash

curl -X POST 'https://v2.api.sol-incinerator.com/batch/close-all' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY' \
  -d '{
    "userPublicKey": "YOUR_WALLET_PUBKEY",
    "limit": 500,
    "offset": 0
  }'

TypeScript

typescript

const res = await fetch("https://v2.api.sol-incinerator.com/batch/close-all", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "x-api-key": process.env.BURN_API_KEY!,
  },
  body: JSON.stringify({ userPublicKey, limit: 500, offset: 0 }),
});

const { transactions } = await res.json();

// Sign and send each transaction
for (const raw of transactions) {
  const tx = VersionedTransaction.deserialize(
    bs58.decode(raw),
  );
  tx.sign([userKeypair]);
  await connection.sendTransaction(tx);
}

Response

json

{
  "transactions": ["AQAAAA...", "BQAAAA..."],
  "accountsClosed": 12,
  "totalLamportsReclaimed": 23981940,
  "totalSolanaReclaimed": 0.02398194,
  "hasDestructiveActions": false,
  "totalAccountsFound": 12,
  "truncated": false
}

Field	Type	Description
transactions	string[]	Array of base58-serialized transactions for the user to sign and send.
accountsClosed	integer	Number of token accounts closed in this batch.
totalLamportsReclaimed	integer	Total lamports reclaimed across all accounts.
totalSolanaReclaimed	number	SOL equivalent of totalLamportsReclaimed.
hasDestructiveActions	boolean	Always false for close-account operations.
totalAccountsFound	integer	Total empty accounts discovered for this wallet.
truncated	boolean	True if results were limited by the limit parameter.
nextOffset	integer	Offset to use for the next page when truncated is true. Omitted when not truncated.

POST/batch/close-all/preview

Preview the outcome of a batch close-all operation before signing.

Parameter	Type	Required	Default	Description
userPublicKey	string (base58)	Yes	-	The wallet public key of the user initiating the action.
offset	integer (>= 0)	No	0	Number of token accounts to skip before processing. Used for pagination.
limit	integer (1-1000)	No	500	Maximum number of token accounts to preview. Range: 1-1000.
feePayer	string (base58)	No	userPublicKey	Public key of the account that pays transaction fees. Defaults to the userPublicKey when omitted.
priorityFeeMicroLamports	integer	No	auto-estimated	Priority fee in micro-lamports to include with the transaction. When omitted the API auto-estimates an appropriate value.
asLegacyTransaction	boolean	No	false	When true, returns a legacy transaction instead of a versioned (v0) transaction.
partnerFeeAccount	string (base58)	No	-	Public key of the partner account that receives a share of the reclaimed SOL. Must be provided together with partnerFeeBps.
partnerFeeBps	integer (0-9800)	No	-	Fee share in basis points (0-9800) directed to the partnerFeeAccount. Must be provided together with partnerFeeAccount.
referralCode	string	No	-	2-20 lowercase alphanumeric characters. Accepted on all core burn/sell/close POST endpoints (including preview/summary where available). Referrers receive 20% of future protocol fees from referred wallets for life. If a wallet already used another referral code, the API will not reassign it. Create and claim rewards at https://sol-incinerator.com/rewards. Mutually exclusive with partnerFeeAccount/partnerFeeBps.

cURL

bash

curl -X POST 'https://v2.api.sol-incinerator.com/batch/close-all/preview' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY' \
  -d '{
    "userPublicKey": "YOUR_WALLET_PUBKEY",
    "limit": 500
  }'

TypeScript

typescript

const res = await fetch("https://v2.api.sol-incinerator.com/batch/close-all/preview", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "x-api-key": process.env.BURN_API_KEY!,
  },
  body: JSON.stringify({ userPublicKey, limit: 500 }),
});

const preview = await res.json();
console.log(
  `${preview.accountsToClose} accounts, ` +
  `${preview.totalSolanaReclaimed} SOL reclaimable`
);

Response

json

{
  "accountPreviews": [
    {
      "assetId": "5abc...",
      "transactionType": "TOKEN_CLOSE",
      "lamportsReclaimed": 1998495,
      "solanaReclaimed": 0.001998495,
      "isDestructiveAction": false
    }
  ],
  "accountsPreviewed": 12,
  "accountsToClose": 12,
  "totalAccountsFound": 12,
  "totalLamportsReclaimed": 23981940,
  "totalSolanaReclaimed": 0.02398194,
  "estimatedTransactions": 2,
  "hasDestructiveActions": false,
  "summary": {
    "standardTokenAccounts": 10,
    "token2022Accounts": 2
  },
  "truncated": false
}

Field	Type	Description
accountPreviews	array	Per-account preview with assetId, transactionType, lamports/SOL reclaimed, and destruction flag.
accountsPreviewed	integer	Number of accounts included in the preview.
accountsToClose	integer	Number of accounts included in this preview page.
totalAccountsFound	integer	Total empty accounts discovered for this wallet.
totalLamportsReclaimed	integer	Total lamports reclaimable across all previewed accounts.
totalSolanaReclaimed	number	SOL equivalent of totalLamportsReclaimed.
estimatedTransactions	integer	Estimated number of transactions needed for the accounts returned in this preview page.
hasDestructiveActions	boolean	Always false for close-account operations.
summary	object	Breakdown by account type: standardTokenAccounts and token2022Accounts.
truncated	boolean	True if results were limited by the limit parameter.
nextOffset	integer	Offset to use for the next page when truncated is true. Omitted when not truncated.

POST/batch/close-all/summary

Fast count of closeable accounts and total reclaimable SOL without building transactions. Scans all empty accounts regardless of limit.

Parameter	Type	Required	Default	Description
userPublicKey	string (base58)	Yes	-	The wallet public key of the user initiating the action.
partnerFeeAccount	string (base58)	No	-	Public key of the partner account that receives a share of the reclaimed SOL. Must be provided together with partnerFeeBps.
partnerFeeBps	integer (0-9800)	No	-	Fee share in basis points (0-9800) directed to the partnerFeeAccount. Must be provided together with partnerFeeAccount.
referralCode	string	No	-	2-20 lowercase alphanumeric characters. Accepted on all core burn/sell/close POST endpoints (including preview/summary where available). Referrers receive 20% of future protocol fees from referred wallets for life. If a wallet already used another referral code, the API will not reassign it. Create and claim rewards at https://sol-incinerator.com/rewards. Mutually exclusive with partnerFeeAccount/partnerFeeBps.

cURL

bash

curl -X POST 'https://v2.api.sol-incinerator.com/batch/close-all/summary' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY' \
  -d '{
    "userPublicKey": "YOUR_WALLET_PUBKEY"
  }'

TypeScript

typescript

const res = await fetch("https://v2.api.sol-incinerator.com/batch/close-all/summary", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "x-api-key": process.env.BURN_API_KEY!,
  },
  body: JSON.stringify({ userPublicKey }),
});

const summary = await res.json();
console.log(
  `${summary.emptyAccountCount} empty accounts, ` +
  `${summary.totalSolanaReclaimable} SOL reclaimable`
);

Response

json

{
  "emptyAccountCount": 12,
  "totalLamportsReclaimable": 23981940,
  "totalSolanaReclaimable": 0.02398194,
  "summary": {
    "standardTokenAccounts": 10,
    "token2022Accounts": 2
  }
}

Field	Type	Description
emptyAccountCount	integer	Total number of empty token accounts found.
totalLamportsReclaimable	integer	Total lamports reclaimable across all empty accounts.
totalSolanaReclaimable	number	SOL equivalent of totalLamportsReclaimable.
summary	object	Breakdown by account type (standardTokenAccounts, token2022Accounts).

POST/batch/close-all-instructions

Return raw serialized instructions for a batch close-all operation.

Parameter	Type	Required	Default	Description
userPublicKey	string (base58)	Yes	-	The wallet public key of the user initiating the action.
offset	integer (>= 0)	No	0	Number of token accounts to skip before processing. Used for pagination.
limit	integer (1-5000)	No	500	Maximum number of token accounts to include in a single batch. Range: 1-5000.
partnerFeeAccount	string (base58)	No	-	Public key of the partner account that receives a share of the reclaimed SOL. Must be provided together with partnerFeeBps.
partnerFeeBps	integer (0-9800)	No	-	Fee share in basis points (0-9800) directed to the partnerFeeAccount. Must be provided together with partnerFeeAccount.
referralCode	string	No	-	2-20 lowercase alphanumeric characters. Accepted on all core burn/sell/close POST endpoints (including preview/summary where available). Referrers receive 20% of future protocol fees from referred wallets for life. If a wallet already used another referral code, the API will not reassign it. Create and claim rewards at https://sol-incinerator.com/rewards. Mutually exclusive with partnerFeeAccount/partnerFeeBps.

cURL

bash

curl -X POST 'https://v2.api.sol-incinerator.com/batch/close-all-instructions' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY' \
  -d '{
    "userPublicKey": "YOUR_WALLET_PUBKEY",
    "limit": 500
  }'

TypeScript

typescript

const res = await fetch("https://v2.api.sol-incinerator.com/batch/close-all-instructions", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "x-api-key": process.env.BURN_API_KEY!,
  },
  body: JSON.stringify({ userPublicKey, limit: 500 }),
});

const { instructionGroups } = await res.json();

// Build your own transactions from instruction groups
for (const group of instructionGroups) {
  for (const ix of group.instructions) {
    transaction.add(deserializeInstruction(ix));
  }
}

Response

json

{
  "instructionGroups": [
    {
      "assetId": "5abc...",
      "instructions": [{ "programId": "CLEANALo6FtS6quqTTEXDGFFTuSKMkeKGgcweeiPRJzK", "accounts": [...], "data": "..." }],
      "lamportsReclaimed": 1998495,
      "solanaReclaimed": 0.001998495,
      "transactionType": "TOKEN_CLOSE",
      "isDestructiveAction": false
    }
  ],
  "accountsClosed": 12,
  "totalLamportsReclaimed": 23981940,
  "totalSolanaReclaimed": 0.02398194,
  "hasDestructiveActions": false,
  "totalAccountsFound": 12,
  "truncated": false
}

Field	Type	Description
instructionGroups	array	Groups of instructions, each for one account. Contains assetId, instructions, lamports/SOL reclaimed, type, and destruction flag.
accountsClosed	integer	Number of accounts closed in this batch.
totalLamportsReclaimed	integer	Total lamports reclaimed across all accounts.
totalSolanaReclaimed	number	SOL equivalent of totalLamportsReclaimed.
hasDestructiveActions	boolean	Always false for close-account operations.
totalAccountsFound	integer	Total empty accounts discovered for this wallet.
truncated	boolean	True if results were limited by the limit parameter.
nextOffset	integer	Offset to use for the next page when truncated is true. Omitted when not truncated.

Execution Endpoints

Relay signed transactions through the API. This is ideal for agent flows after local signing with a user keypair.

POST/transactions/send

Relay one signed transaction through the API and optionally wait for confirmation.

Parameter	Type	Required	Default	Description
signedTransaction	string	Yes	-	Signed serialized transaction payload. Default encoding is base58.
encoding	"base58" \| "base64"	No	base58	Encoding used for signedTransaction/signedTransactions payload fields.
skipPreflight	boolean	No	false	Forwarded to Solana sendRawTransaction options.
maxRetries	integer (0-100)	No	-	Forwarded to Solana sendRawTransaction options.
minContextSlot	integer (>= 0)	No	-	Forwarded to Solana sendRawTransaction options.
preflightCommitment	"processed" \| "confirmed" \| "finalized"	No	confirmed	Preflight commitment for transaction submission. If omitted, the API uses confirmed.
waitForConfirmation	boolean	No	false	When true, the API polls signature status until the target commitment or timeout.
confirmationCommitment	"processed" \| "confirmed" \| "finalized"	No	confirmed	Target commitment used when waitForConfirmation is true.
confirmationTimeoutMs	integer (1000-180000)	No	30000	Maximum wait duration for confirmation polling.
pollIntervalMs	integer (100-5000)	No	1250	Polling interval for confirmation checks.

cURL

bash

curl -X POST 'https://v2.api.sol-incinerator.com/transactions/send' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY' \
  -d '{
    "signedTransaction": "BASE58_OR_BASE64_SIGNED_TX",
    "waitForConfirmation": true
  }'

TypeScript

typescript

const relay = await fetch("https://v2.api.sol-incinerator.com/transactions/send", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "x-api-key": process.env.BURN_API_KEY!,
  },
  body: JSON.stringify({
    signedTransaction,
    waitForConfirmation: true,
  }),
});

const result = await relay.json();
console.log(result.signature, result.confirmation);

Response

json

{
  "signature": "4G3k...abc",
  "sent": true,
  "confirmation": {
    "commitment": "confirmed",
    "confirmed": true,
    "timedOut": false,
    "status": {
      "slot": 312345678,
      "confirmations": null,
      "confirmationStatus": "confirmed",
      "err": null
    }
  }
}

Field	Type	Description
signature	string	Transaction signature returned by RPC.
sent	boolean	True when submission to RPC succeeded.
confirmation	object	Present when waitForConfirmation is true; includes confirmed/timedOut/status.

POST/transactions/send-batch

Relay multiple signed transactions in parallel with bounded concurrency and per-item results.

Parameter	Type	Required	Default	Description
signedTransactions	string[]	Yes	-	Array of signed serialized transaction payloads. Default encoding is base58.
encoding	"base58" \| "base64"	No	base58	Encoding used for signedTransaction/signedTransactions payload fields.
maxConcurrency	integer (1-32)	No	8	Parallel send concurrency for /transactions/send-batch.
skipPreflight	boolean	No	false	Forwarded to Solana sendRawTransaction options.
maxRetries	integer (0-100)	No	-	Forwarded to Solana sendRawTransaction options.
minContextSlot	integer (>= 0)	No	-	Forwarded to Solana sendRawTransaction options.
preflightCommitment	"processed" \| "confirmed" \| "finalized"	No	confirmed	Preflight commitment for transaction submission. If omitted, the API uses confirmed.
waitForConfirmation	boolean	No	false	When true, the API polls signature status until the target commitment or timeout.
confirmationCommitment	"processed" \| "confirmed" \| "finalized"	No	confirmed	Target commitment used when waitForConfirmation is true.
confirmationTimeoutMs	integer (1000-180000)	No	30000	Maximum wait duration for confirmation polling.
pollIntervalMs	integer (100-5000)	No	1250	Polling interval for confirmation checks.

cURL

bash

curl -X POST 'https://v2.api.sol-incinerator.com/transactions/send-batch' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY' \
  -d '{
    "signedTransactions": ["SIGNED_TX_1", "SIGNED_TX_2"],
    "maxConcurrency": 4
  }'

TypeScript

typescript

const relay = await fetch("https://v2.api.sol-incinerator.com/transactions/send-batch", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "x-api-key": process.env.BURN_API_KEY!,
  },
  body: JSON.stringify({
    signedTransactions,
    maxConcurrency: 4,
  }),
});

const batch = await relay.json();
console.log(batch.sentCount, batch.failedCount, batch.results);

Response

json

{
  "sentCount": 2,
  "failedCount": 1,
  "results": [
    { "index": 0, "sent": true, "signature": "2v9..." },
    { "index": 1, "sent": true, "signature": "9Qa..." },
    { "index": 2, "sent": false, "error": "blockhash not found" }
  ]
}

Field	Type	Description
sentCount	integer	How many transactions were accepted by RPC.
failedCount	integer	How many transactions failed to submit.
results	array	Per-index send result with signature or error details.

POST/transactions/status

Lookup confirmation status and errors for a transaction signature.

Parameter	Type	Required	Default	Description
signature	string	Yes	-	Transaction signature to look up.
searchTransactionHistory	boolean	No	true	Whether to include rooted history in signature status lookup.

cURL

bash

curl -X POST 'https://v2.api.sol-incinerator.com/transactions/status' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY' \
  -d '{
    "signature": "4G3k...abc"
  }'

TypeScript

typescript

const statusRes = await fetch("https://v2.api.sol-incinerator.com/transactions/status", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "x-api-key": process.env.BURN_API_KEY!,
  },
  body: JSON.stringify({ signature }),
});

const status = await statusRes.json();
console.log(status.found, status.status);

Response

json

{
  "signature": "4G3k...abc",
  "found": true,
  "status": {
    "slot": 312345678,
    "confirmations": null,
    "confirmationStatus": "finalized",
    "err": null
  }
}

Field	Type	Description
signature	string	Signature from request.
found	boolean	True when RPC returns a status for this signature.
status	object \| null	Signature status payload (slot, confirmationStatus, err).

Fee Model

Basis-point fees applied to reclaimable rent with floor arithmetic.

Protocol Fee

200 BPS (2.00%) of reclaimable rent, applied to every operation.

fee = floor(reclaimableRent * 200 / 10000)

User Receives

Reclaimable rent minus protocol fee and any optional partner fee.

userReceives = reclaimableRent - protocolFee - partnerFee

Worked Example

A token account with 2,039,280 lamports (0.00204 SOL) in reclaimable rent:

Protocol feefloor(2,039,280 × 200 / 10,000) = 40,785 lamports

User receives2,039,280 − 40,785 = 1,998,495 lamports (0.001998495 SOL)

Partner Fee System

Integrators can collect a fee on each operation by providing a partner account and fee rate.

Configuration

partnerFeeAccountBase58 public key receiving the fee

partnerFeeBpsInteger 0-9800 (100 BPS = 1%)

Both must be provided together, or both omitted. Fee is deducted from reclaimable rent alongside the protocol fee.

Example

Same 2,039,280 lamport account with partnerFeeBps: 150 (1.5%):

Protocol feefloor(2,039,280 × 200 / 10,000) = 40,785

Partner feefloor(2,039,280 × 150 / 10,000) = 30,589

User receives2,039,280 − 40,785 − 30,589 = 1,967,906

Referral Code System

Use referralCodeon burn/close requests to apply a referral code. Referrers earn 20% of a referred wallet's future protocol fees for life. Create a code and claim rewards on https://sol-incinerator.com/rewards.

Behavior

FieldreferralCode

Format2-20 lowercase alphanumeric

Payout20% of future protocol fees for life

ReassignmentNo (existing referral stays)

Create + Claimsol-incinerator.com/rewards

Current Effect

Send referralCode in burn/close requests to count activity toward that referral code. Referrers receive 20% of future protocol fees from referred wallets for life. If a wallet already used a different referral code, the API will not reassign it to your code. Rewards are managed at https://sol-incinerator.com/rewards.

Referral + Partner Parameters

These two monetization approaches are mutually exclusive. The API rejects requests that include both partnerFeeAccount/partnerFeeBps and referralCode with a 400 error.

Partner Fees

Direct cut of reclaimable rent at a rate you control. Funds go to your partner account on-chain in the same transaction.

Referral Codes

Use referralCode to apply a referral code and earn 20% of future protocol fees for life. Existing referred wallets are not reassigned to a new code. Create and claim rewards on sol-incinerator.com/rewards.

Errors & Rate Limits

HTTP status codes and rate limiting behavior.

Status	Meaning
400	Invalid payload or unsupported parameter combination
401	Missing or invalid API key / bearer token / session token
403	Admin role required or missing token scope
409	One-key policy conflict
429	Rate limit exceeded

Standard Endpoints

240 requests/minute per route + identity

Heavy Endpoints

60 requests/minute for /batch/close-all, /batch/close-all/preview, /batch/close-all/summary, and /batch/close-all-instructions, /cleanup/all, /cleanup/all/summary, /pump/summary, /pump/close-all, and /pump/close-all-instructions

AI & Tooling Integration

Hosted MCP endpoint/mcp

OAuth protected-resource metadata/.well-known/oauth-protected-resource

OAuth auth-server metadata/.well-known/oauth-authorization-server

OpenAPI spec/openapi.json

API catalog (RFC 9727)/.well-known/api-catalog

LLM index/llms.txt

LLM markdown guide/llms.md

Use our hosted MCP server to expose burn, sell, and close API operations as tools in Codex and Claude.

Codex CLI

bash

codex mcp add solincinerator --url "https://v2.api.sol-incinerator.com/mcp"

Codex Config (config.toml)

toml

[mcp_servers.solincinerator]
url = "https://v2.api.sol-incinerator.com/mcp"

Claude CLI

bash

claude mcp add -s user -t http solincinerator "https://v2.api.sol-incinerator.com/mcp"

Execution tools only relay signed payloads. The wallet owner must sign transactions locally with their private key/keypair before using send_transaction or send_transaction_batch.

Start with signing_requirements to get the expected signer flow and a known-good Node snippet (including correct bs58 import shape).

MCP Tools

text

signing_requirements
burn
burn_preview
burn_instructions
sell_batch
close
close_preview
close_instructions
close_wallet
close_wallet_preview
batch_close_all
batch_close_all_preview
batch_close_all_summary
batch_close_all_instructions
cleanup_all
cleanup_all_summary
pump_summary
pump_close_all
pump_close_all_instructions
send_transaction
send_transaction_batch
get_transaction_status
get_status
get_openapi
get_api_catalog
get_llms_index
get_llms_markdown
get_llms_full
get_docs_markdown

Help & Support

If you run into issues or discover a bug, please create a ticket in our Discord server.

Join Sol Slugs Discord

Sol Incinerator API Integration Guide

Quick Start

Build a Burn Transaction

Run Unified Cleanup

Authentication

Burn Endpoints

Sell Endpoints

Close Endpoints

Batch Endpoints

Execution Endpoints

Fee Model

Protocol Fee

User Receives

Worked Example

Partner Fee System

Configuration

Example

Referral Code System

Behavior

Current Effect

Referral + Partner Parameters

Partner Fees

Referral Codes

Errors & Rate Limits

Standard Endpoints

Heavy Endpoints

AI & Tooling Integration

Help & Support