Raze.bot Developers

The /utils/sol/* endpoints live on the History API (https://api.raze.bot) alongside /api/sol/* reads. They cover the non-swap workflows previously hosted on the legacy public.raze.sh service (and briefly on router.raze.bot): token launches, fee management, SOL/SPL transfers, distribution, and consolidation. Swap / quote / buy / sell / instructions remain on https://router.raze.bot. All endpoints require an API key (same scheme as other History routes — X-API-Key, Authorization: Bearer sk_..., or ?apiKey=sk_...).

Endpoints

Transfer

Batch SOL + SPL + Token-2022 transfers. One request → as few txs as fit.

Burn

Batch burn SPL or Token-2022 tokens across many wallets and mints.

Distribute

One→many SOL distribute.

Consolidate

Many→one SOL sweep, percentage-based.

Launch

Token launch (pumpfun / bonk / meteora_dbc / meteora_cpamm).

Fees: Claim

Claim pump.fun creator fees or Meteora partner/creator fees.

Fees: Config

Manage pump.fun creator-fee sharing config.

Batch semantics

transfer and burn are the two endpoints that accept a true batch (items[]). The server groups items by their signer (sender for transfer, wallet for burn) and bin-packs each group into as few versioned transactions as the 1232-byte wire limit allows. Items that share a signer share a tx; items with different signers go to different txs. The response includes a batches[] array describing the packing — batches[i] describes transactions[i], telling you which input item indices ended up in that tx and how many non-fee instructions it contains. That lets you do partial-retry logic when one tx in a batch lands and another doesn’t.

// Request: 4 items, two senders
{
  "items": [
    { "sender": "A...", "receiver": "X...", "amount": 0.1 },
    { "sender": "A...", "receiver": "Y...", "tokenAddress": "USDC...", "amount": 5 },
    { "sender": "B...", "receiver": "Z...", "amount": 0.2 },
    { "sender": "A...", "receiver": "W...", "amount": 0.05 }
  ]
}

// Response: 2 txs (one per signer)
{
  "success": true,
  "transactions": ["base64...", "base64..."],
  "batches": [
    { "signers": ["A..."], "itemIndices": [0, 1, 3], "instructionCount": 3 },
    { "signers": ["B..."], "itemIndices": [2],       "instructionCount": 1 }
  ]
}

Common request flags

Flag	Default	What it does
`encoding`	`base64`	Output transaction encoding. `base58` supported for legacy callers.
`simulate`	`false`	When true, every built tx is run through `simulateTransaction` and the result is attached as `simulations[i]`.
`tipWallet`	Raze relay wallet	Custom tip recipient.
`tipLamports`	—	Flat tip transfer (floored at 100000 lamports). Omit for no tip — utils transactions carry no implicit service fee.
`feeTipLamports`	—	Legacy alias for `tipLamports` (tips the Raze relay wallet). `tipLamports` wins when both are set.
`feeWallet` + `feeBps`	—	Custom percentage fee, same contract as the swap endpoints: `feeBps` basis points of the SOL volume the endpoint moves, sent to `feeWallet` (both required). Bases: transfer = each SOL item, consolidate = SOL swept per tx, distribute = each recipient’s amount, launch = each buyer’s quote amount. Endpoints with no SOL volume (burn, agent, fees) charge nothing.
`transactionsFeeLamports`	—	When set, compute-budget instructions are prepended to every output tx.
`maxInstructionsPerTx`	auto	Optional cap on non-fee instructions per tx. Default fits the 1232-byte budget.

Common response envelope

{
  success: boolean,
  transactions?: string[],          // serialized partially-signed v0 txs
  batches?: BatchInfo[],            // per-tx packing metadata (transfer/burn)
  mint?: string,                    // launch only
  platform?: string,                // launch + fees/claim only
  status?: object,                  // fees/config status reads
  simulations?: object[],           // present when simulate: true
  error?: string,                   // non-fatal partial-failure summary
}

Token program autodetection

Anywhere a tokenAddress (mint) appears, the server batch-fetches the mint account in one getMultipleAccounts call and detects whether the mint is owned by the SPL Token program or Token-2022. The right program ID is used for ATA derivation and transfer_checked / burn_checked instruction building. Callers don’t pass a tokenProgram flag. Token-2022 mints with the transfer-fee extension are not yet supported and will fail on-chain. Open an issue if you hit one and we’ll add transfer_checked_with_fee.

Migration from `public.raze.sh` / `router.raze.bot`

Legacy	Current
`POST https://public.raze.sh/api/sol/transfer`	`POST https://api.raze.bot/utils/sol/transfer`
`POST https://public.raze.sh/api/sol/burn`	`POST https://api.raze.bot/utils/sol/burn`
`POST https://public.raze.sh/api/sol/distribute`	`POST https://api.raze.bot/utils/sol/distribute`
`POST https://public.raze.sh/api/sol/consolidate`	`POST https://api.raze.bot/utils/sol/consolidate`
`POST https://public.raze.sh/api/sol/create`	`POST https://api.raze.bot/utils/sol/launch`
`POST https://public.raze.sh/api/sol/fee-claim`	`POST https://api.raze.bot/utils/sol/fees/claim`
`POST https://public.raze.sh/api/sol/fee-config`	`POST https://api.raze.bot/utils/sol/fees/config`
`POST https://router.raze.bot/utils/sol/*`	`POST https://api.raze.bot/utils/sol/*`

The legacy GET /api/metadata/*, GET /api/image/*, and POST /api/upload endpoints have no public replacement — read Metaplex / Token-2022 metadata via Solana RPC, serve images through a CDN, and pin to IPFS via Pinata directly. The new endpoints require an API key (the legacy service was open). Default output encoding is base64 (legacy was base58); pass encoding: "base58" for byte-for-byte compatibility.

Perpetuals

Batch transfer (SOL + SPL + Token-2022)

GraphQL

Utilities

Price

Trades

Tokens

Wallets

Funding & Bubblemap

Platform

Alerts

Sentiment

Perpetuals

Transactions

Overview

Endpoints

Transfer

Burn

Distribute

Consolidate

Launch

Fees: Claim

Fees: Config

Batch semantics

Common request flags

Common response envelope

Token program autodetection

Migration from `public.raze.sh` / `router.raze.bot`

​Endpoints

Transfer

Burn

Distribute

Consolidate

Launch

Fees: Claim

Fees: Config

​Batch semantics

​Common request flags

​Common response envelope

​Token program autodetection

​Migration from public.raze.sh / router.raze.bot

Endpoints

Batch semantics

Common request flags

Common response envelope

Token program autodetection

Migration from `public.raze.sh` / `router.raze.bot`