Skip to main content
POST
Batch transfer (SOL + SPL + Token-2022)

Authorizations

apiKey
string
query
required

Body

application/json

Batch transfer. Either pass items[] for the full batched form, or use the top-level sender / receiver / tokenAddress / amount for the legacy single-item shape. Items are grouped by sender and packed into the fewest possible 1232-byte transactions.

items
object[]
sender
string
receiver
string
tokenAddress
string
amount
number
feeTipLamports
integer

Legacy alias for tipLamports — tips the Raze relay wallet.

tipWallet
string

Custom tip recipient wallet (defaults to the Raze relay tip wallet).

tipLamports
integer

Flat tip in lamports, floored at 100000. Takes precedence over feeTipLamports.

feeWallet
string

Custom fee recipient wallet. Only charged together with feeBps.

feeBps
integer

Percentage fee in basis points of the SOL volume this endpoint moves, sent to feeWallet. Endpoints with no SOL volume charge nothing.

transactionsFeeLamports
integer

Optional priority fee in lamports. When set, compute-budget instructions are added to every output tx.

encoding
enum<string>
default:base64
Available options:
base64,
base58
maxInstructionsPerTx
integer

Optional cap on non-fee instructions per tx. Default = whatever fits the 1232-byte budget.

simulate
boolean
default:false

Response

Transactions built

Shared envelope for every /utils/sol/* write endpoint. Optional fields are omitted from the JSON when unset.

success
boolean
required
transactions
string[]

Serialized partially-signed transactions in submission order.

batches
object[]

For batch endpoints (transfer, burn): packing metadata. batches[i] describes transactions[i].

mint
string

Set by /utils/sol/launch — the mint of the launched token.

platform
string

Set by /utils/sol/launch and /utils/sol/fees/claim.

status
object

Set by /utils/sol/fees/config for action=status reads.

simulations
object[]

Set when the request had simulate: true. One entry per built tx, in the same order as transactions. Each entry is the RPC simulateTransaction value object (logs / unitsConsumed / err).

error
string