submit-batch

This endpoint allows you to submit multiple signed transactions under a single request to reduce network call overhead. Additionally supports block engine bundles.

circle-info

Enabling useBundle=true may introduce additional latency because transactions are routed through bundle engines across multiple hops. Use it only when revert protection is required or execution speed is not critical.

The maximum batch size is 25 signed transactions. If useBundle=true, the maximum batch size is reduced to 4 signed transactions to adhere to third-party block engine requirements.

Each signed transaction in the batch must satisfy the standard tip requirements described in our tip documentation here. When useBundle=true, the tip should only be included in the final transaction in the batch.

Request

Method:

POST ./api/v2/submit-batch

Parameters:

Parameter
Type
Description

entries

PostSubmitRequestEntry []

A list of signed transactions. See PostSubmitRequestEntry below

useBundle

boolean

OPTIONAL. Specify if you would like to send transactions as a bundle only (all transactions land or none at all). Default false.

frontRunningProtection

boolean

OPTIONAL. Our infrastructure scores current and upcoming slot leaders in real time, identifying validators with an elevated risk of malicious ordering. High-risk leaders (identified through sandwich correlations and validator behaviour analytics) are delayed or skipped. Low-risk leaders receive accelerated submission through staked connections, improving both protection and time-to-land. Default False.

PostSubmitRequestEntry

Parameter
Description

transaction

TransactionMessage

See TransactionMessage below

skipPreFlight

boolean

OPTIONAL. Useful for disabling transaction simulation before actual submission. Default false.

TransactionMessage

Parameter
Description

content

txbase64Payload

Base64 signed transaction bytes

Request example:

Response:

Fields:

Field
Type
Description

transactions

list

A list of signatures.

Field
Type
Description

signature

string

Solana signature of the submitted transaction

error

string

Return error message.

submitted

boolean

If the transaction has been submitted.

Example:

You can look up this signature in a Solana Explorer like SolScanarrow-up-right or Solana Explorerarrow-up-right.

Last updated