# submit-batch

{% hint style="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.
{% endhint %}

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](/solana/trader-api/introduction/tip-and-tipping-addresses.md). When `useBundle=true`, the tip should only be included in the final transaction in the batch.

## Request

#### Method:

`POST ./api/v2/submit-batch`

#### Parameters:

<table><thead><tr><th width="222.87353515625">Parameter</th><th width="251.2">Type</th><th width="445">Description</th></tr></thead><tbody><tr><td><code>entries</code></td><td><code>PostSubmitRequestEntry</code><br>[]</td><td>A list of signed transactions. See <code>PostSubmitRequestEntry</code> below</td></tr><tr><td><code>useBundle</code></td><td>boolean</td><td><strong>OPTIONAL.</strong> Specify if you would like to send transactions as a bundle only (all transactions land or none at all). Default <code>false</code>.</td></tr><tr><td><code>frontRunningProtection</code></td><td>boolean</td><td><strong>OPTIONAL.</strong> 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 <code>False</code>.</td></tr></tbody></table>

`PostSubmitRequestEntry`

<table><thead><tr><th width="192">Parameter</th><th width="218.2"></th><th width="445">Description</th></tr></thead><tbody><tr><td><code>transaction</code></td><td><code>TransactionMessage</code></td><td>See <code>TransactionMessage</code> below</td></tr><tr><td><code>skipPreFlight</code></td><td>boolean</td><td><strong>OPTIONAL.</strong> Useful for disabling transaction simulation before actual submission. Default <code>false</code>.</td></tr></tbody></table>

`TransactionMessage`

<table><thead><tr><th width="181">Parameter</th><th width="166.2"></th><th width="390">Description</th></tr></thead><tbody><tr><td><code>content</code></td><td>txbase64Payload</td><td>Base64 signed transaction bytes</td></tr></tbody></table>

#### Request example:

{% tabs %}
{% tab title="HTTP" %}

```bash
curl -X POST "http://ny.solana.dex.blxrbdn.com/api/v2/submit-batch" \
  -H "Authorization: $AUTH_HEADER" \
  -H "Content-Type: application/json" \
  -d '{
    "entries": [
      {
        "transaction": {
          "content": "AayHbuFlHrJV5V53CAyBW0IM6PHeqfbIF2PegMEU..."
        },
        "skipPreFlight": false
      },
      {
        "transaction": {
          "content": "AeNTbB0vnGNSGVybg/mzbtfZzmwvNPJsWgmQJshxK..."
        },
        "skipPreFlight": false
      },
      {
        "transaction": {
          "content": "AUTTE4Oa9qKhimePjDHGpnh9F5FtRfMwuPuVGyxytt..."
        },
        "skipPreFlight": false
      }
    ],
    "useBundle": false,
    "frontRunningProtection": false
  }'
```

{% endtab %}

{% tab title="WebSocket" %}

```bash
• wscat -c ws://ny.solana.dex.blxrbdn.com/ws --execute '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "PostSubmitBatchV2",
    "params": {
      "entries": [
        {
          "transaction": {
            "content": "AayHbuFlHrJV5V53CAyBW0IM6PHeqfbIF2PegMEUOzc1gQ7Qe8NDgk1XnpKLIwwO..."
          },
          "skipPreFlight": false
        },
        {
          "transaction": {
            "content": "AeNTbB0vnGNSGVybg/mzbtfZzmwvNPJsWgmQJshxKp6aAxu3wAaWPmZUupbBat0u..."
          },
          "skipPreFlight": false
        },
        {
          "transaction": {
            "content": "AUTTE4Oa9qKhimePjDHGpnh9F5FtRfMwuPuVGyxyttlIuIwSrW8KLbqjsGtPzGDH..."
          },
          "skipPreFlight": false
        }
      ],
      "useBundle": false,
      "frontRunningProtection": false
    }
  }'
```

{% endtab %}
{% endtabs %}

### Response:

#### Fields:

<table><thead><tr><th width="214">Field</th><th width="110">Type</th><th width="422">Description</th></tr></thead><tbody><tr><td><code>transactions</code></td><td>list</td><td>A list of signatures.</td></tr></tbody></table>

<table><thead><tr><th width="214">Field</th><th width="110">Type</th><th width="422">Description</th></tr></thead><tbody><tr><td><code>signature</code></td><td>string</td><td>Solana signature of the submitted transaction</td></tr><tr><td><code>error</code></td><td>string</td><td>Return error message.</td></tr><tr><td><code>submitted</code></td><td>boolean</td><td>If the transaction has been submitted.</td></tr></tbody></table>

#### Example:

{% tabs %}
{% tab title="JSON" %}

```json
{
	"transactions": [
		{
			"signature": "4T4ou8LBZ3y8mDvJQyv6FwzWYyrVun6imocEJPTsZ8sqM6BwzhjErujAyj3xMD1SDjysxVP2pAopKR8yHkCGUhon",
			"submitted": true
		},
		{
			"signature": "5YcHd1LwkzfPACWBdBq7rfb1pRMf9ypyp4tJrngMpN8nTJnG11NGLA8KMaoUrWivWtVRyCcjXP9oaGmJSsJhpGBk",
			"submitted": true
		},
		{
			"signature": "2NowWRYoqFibBrz7b8iivtyhoc6WRx1WSN9ZusbEcXk4Waw5a1udYkBbK7x5eYVfLyQsN116ND1VmVoeHUgyNh7b",
			"submitted": true
		}
	]
}
```

{% endtab %}
{% endtabs %}

You can look up this signature in a Solana Explorer like [SolScan](https://solscan.io/) or [Solana Explorer](https://explorer.solana.com/).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.bloxroute.com/solana/trader-api/api-endpoints/transaction-submisson/submit-batch.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
