Sol-Incinerator Burn + Close API v2 Guide
A practical integration guide for Sol-Incinerator's HTTP API. The main user-facing outcomes are burning tokens, burning NFTs, and closing token accounts, while still supporting advanced batch cleanup and relay workflows.
Live API base URL: https://v2.api.sol-incinerator.com
Overview
Sol-Incinerator API v2 provides:
- Autonomous API key provisioning via
POST /api-keys/generate
- Burn/close transaction building for SPL Token, Token-2022, and NFT account patterns
- Instruction-only endpoints when you want full client-side transaction assembly
- Preview/summary endpoints to estimate reclaimed rent and fees before execution
- Transaction relay endpoints to broadcast already-signed payloads
- Partner/referral monetization inputs with built-in validation
Core Endpoint Groups
| Group |
Endpoints |
| Public discovery |
GET /, /openapi.json, /.well-known/api-catalog, /llms*, /DOCS.md |
| Public auth bootstrap |
POST /api-keys/generate |
| Burn + close (API key required) |
/burn, /burn-instructions, /close, /close-instructions, /batch/close-all* |
| Relay + confirmation (API key required) |
/transactions/send, /transactions/send-batch, /transactions/status |
Quick Start
1) Generate API key (no user input)
const baseUrl = 'https://v2.api.sol-incinerator.com';
const keyResp = await fetch(`${baseUrl}/api-keys/generate`, {
method: 'POST',
headers: { 'content-type': 'application/json' },
body: JSON.stringify({ label: 'autonomous-agent' }),
});
if (!keyResp.ok) {
throw new Error(`API key generation failed: ${keyResp.status}`);
}
const { apiKey } = await keyResp.json() as { apiKey: string };
2) Run preview-first flow
const headers = {
'content-type': 'application/json',
'x-api-key': apiKey,
};
const previewResp = await fetch(`${baseUrl}/burn/preview`, {
method: 'POST',
headers,
body: JSON.stringify({
userPublicKey,
assetId,
burnAmount: '1',
}),
});
3) Build, sign, submit
- Call
/burn, /close, or /batch/close-all.
- Decode base58 serialized transaction(s) and sign locally with the wallet keypair.
- Submit through your wallet/RPC flow, or use
/transactions/send and /transactions/send-batch.
- Poll
/transactions/status if needed.
Core Integration Rules
Auth
- Send API key in either:
x-api-key: ak_xxx.yyy (recommended for server agents)
Authorization: Bearer ak_xxx.yyy
- Core routes return
401 when key is missing or invalid.
Required body fields
- Single-asset routes (
/burn, /close, previews, instructions):
- Batch routes (
/batch/close-all*):
Optional body fields used often
feePayer (public key)
asLegacyTransaction (boolean)
priorityFeeMicroLamports (integer)
autoCloseTokenAccounts (boolean, burn flows)
burnAmount (positive integer in atomic units; use string for large values)
offset, limit (batch pagination/windowing)
Partner + referral validation
partnerFeeAccount and partnerFeeBps are all-or-nothing.
partnerFeeBps must be integer 0..9800.
referralCode must be 2-20 lowercase alphanumeric.
referralCode cannot be combined with partner fee fields.
Endpoint Selection
- Use
/burn/preview or /close/preview before execution when:
- the user needs fee visibility
- assets may be frozen/invalid/non-empty
- Use
/burn and /close when:
- you want ready-to-sign transaction payloads
- Use
/burn-instructions and /close-instructions when:
- your app assembles transactions client-side
- Use
/batch/close-all/preview first for wallet cleanup UX
- Use
/batch/close-all/summary for lightweight dashboard counts
- Use
/transactions/send-batch for multi-tx close-all pipelines
Example Workflow (Agent)
- Generate an API key with
POST /api-keys/generate.
- Run preview endpoint for target operation.
- If preview is acceptable, request executable transaction payload.
- Sign transaction locally.
- Submit signed payload.
- Confirm completion via
/transactions/status.
- Store operation metadata (signature, fees, lamports reclaimed).
Guidelines
- DO run preview before destructive operations.
- DO pass
burnAmount as a string for large atomic values.
- DO validate user/asset pubkeys before submitting.
- DO keep private keys local; only send signed transactions to relay endpoints.
- DON'T combine
referralCode with partner fee fields.
- DON'T send unsigned payloads to relay routes.
- DON'T assume base64 encoding for relay payloads unless explicitly set
encoding: "base64" (default is base58).
Resources
Skill Structure
sol-incinerator/
├── SKILL.md # This file
├── resources/
│ └── api-reference.md # Endpoint matrix and request notes
├── examples/
│ └── basic/
│ └── http-flow.ts # Close-account + token/NFT burn examples
├── templates/
│ └── sol-incinerator-client.ts # Ready-to-use TypeScript client
└── docs/
└── troubleshooting.md # Common errors and fixes
1---2name: sol-incinerator3description: SOL Incinerator SDK for burning tokens, NFTs, and closing accounts4metadata:5 source: https://skillmd.com/skills/sendaifun/sol-incinerator6---78# Sol-Incinerator Burn + Close API v2 Guide910A practical integration guide for Sol-Incinerator's HTTP API. The main user-facing outcomes are burning tokens, burning NFTs, and closing token accounts, while still supporting advanced batch cleanup and relay workflows.1112Live API base URL: `https://v2.api.sol-incinerator.com`1314## Overview1516Sol-Incinerator API v2 provides:17- Autonomous API key provisioning via `POST /api-keys/generate`18- Burn/close transaction building for SPL Token, Token-2022, and NFT account patterns19- Instruction-only endpoints when you want full client-side transaction assembly20- Preview/summary endpoints to estimate reclaimed rent and fees before execution21- Transaction relay endpoints to broadcast already-signed payloads22- Partner/referral monetization inputs with built-in validation2324## Core Endpoint Groups2526| Group | Endpoints |27|------|-----------|28| Public discovery | `GET /`, `/openapi.json`, `/.well-known/api-catalog`, `/llms*`, `/DOCS.md` |29| Public auth bootstrap | `POST /api-keys/generate` |30| Burn + close (API key required) | `/burn`, `/burn-instructions`, `/close`, `/close-instructions`, `/batch/close-all*` |31| Relay + confirmation (API key required) | `/transactions/send`, `/transactions/send-batch`, `/transactions/status` |3233## Quick Start3435### 1) Generate API key (no user input)3637```typescript38const baseUrl = 'https://v2.api.sol-incinerator.com';3940const keyResp = await fetch(`${baseUrl}/api-keys/generate`, {41 method: 'POST',42 headers: { 'content-type': 'application/json' },43 body: JSON.stringify({ label: 'autonomous-agent' }),44});4546if (!keyResp.ok) {47 throw new Error(`API key generation failed: ${keyResp.status}`);48}4950const { apiKey } = await keyResp.json() as { apiKey: string };51```5253### 2) Run preview-first flow5455```typescript56const headers = {57 'content-type': 'application/json',58 'x-api-key': apiKey,59};6061const previewResp = await fetch(`${baseUrl}/burn/preview`, {62 method: 'POST',63 headers,64 body: JSON.stringify({65 userPublicKey,66 assetId,67 burnAmount: '1',68 }),69});70```7172### 3) Build, sign, submit73741. Call `/burn`, `/close`, or `/batch/close-all`.752. Decode base58 serialized transaction(s) and sign locally with the wallet keypair.763. Submit through your wallet/RPC flow, or use `/transactions/send` and `/transactions/send-batch`.774. Poll `/transactions/status` if needed.7879## Core Integration Rules8081### Auth8283- Send API key in either:84 - `x-api-key: ak_xxx.yyy` (recommended for server agents)85 - `Authorization: Bearer ak_xxx.yyy`86- Core routes return `401` when key is missing or invalid.8788### Required body fields8990- Single-asset routes (`/burn`, `/close`, previews, instructions):91 - `userPublicKey`92 - `assetId`93- Batch routes (`/batch/close-all*`):94 - `userPublicKey`9596### Optional body fields used often9798- `feePayer` (public key)99- `asLegacyTransaction` (boolean)100- `priorityFeeMicroLamports` (integer)101- `autoCloseTokenAccounts` (boolean, burn flows)102- `burnAmount` (positive integer in atomic units; use string for large values)103- `offset`, `limit` (batch pagination/windowing)104105### Partner + referral validation106107- `partnerFeeAccount` and `partnerFeeBps` are all-or-nothing.108- `partnerFeeBps` must be integer `0..9800`.109- `referralCode` must be `2-20` lowercase alphanumeric.110- `referralCode` cannot be combined with partner fee fields.111112## Endpoint Selection113114- Use `/burn/preview` or `/close/preview` before execution when:115 - the user needs fee visibility116 - assets may be frozen/invalid/non-empty117- Use `/burn` and `/close` when:118 - you want ready-to-sign transaction payloads119- Use `/burn-instructions` and `/close-instructions` when:120 - your app assembles transactions client-side121- Use `/batch/close-all/preview` first for wallet cleanup UX122- Use `/batch/close-all/summary` for lightweight dashboard counts123- Use `/transactions/send-batch` for multi-tx close-all pipelines124125## Example Workflow (Agent)1261271. Generate an API key with `POST /api-keys/generate`.1282. Run preview endpoint for target operation.1293. If preview is acceptable, request executable transaction payload.1304. Sign transaction locally.1315. Submit signed payload.1326. Confirm completion via `/transactions/status`.1337. Store operation metadata (signature, fees, lamports reclaimed).134135## Guidelines136137- DO run preview before destructive operations.138- DO pass `burnAmount` as a string for large atomic values.139- DO validate user/asset pubkeys before submitting.140- DO keep private keys local; only send signed transactions to relay endpoints.141- DON'T combine `referralCode` with partner fee fields.142- DON'T send unsigned payloads to relay routes.143- DON'T assume base64 encoding for relay payloads unless explicitly set `encoding: "base64"` (default is base58).144145## Resources146147- [Canonical docs (v2)](https://api.dashboard.sol-incinerator.com/docs/v2)148- [OpenAPI spec (`/openapi.json`)](https://v2.api.sol-incinerator.com/openapi.json)149- [LLM index (`/llms.txt`)](https://v2.api.sol-incinerator.com/llms.txt)150- [Example flows (close account, burn token, burn NFT)](./examples/basic/http-flow.ts)151152## Skill Structure153154```155sol-incinerator/156├── SKILL.md # This file157├── resources/158│ └── api-reference.md # Endpoint matrix and request notes159├── examples/160│ └── basic/161│ └── http-flow.ts # Close-account + token/NFT burn examples162├── templates/163│ └── sol-incinerator-client.ts # Ready-to-use TypeScript client164└── docs/165 └── troubleshooting.md # Common errors and fixes166```