Batch Landing

Request Format

Batch requests allow you to submit multiple transactions in a single HTTP call. Send an array of JSON-RPC request objects, each following the standard Solana sendTransaction format:

curl -X POST 'https://STELLIUM_ENDPOINT/$APIKEY' \
-H "Content-Type: application/json" \
-d '[
  {
    "jsonrpc": "2.0",
    "id": 1,
    "method": "sendTransaction",
    "params": [
      "<base64_encoded_tx_1>",
      { "encoding": "base64" }
    ]
  },
  {
    "jsonrpc": "2.0",
    "id": 2,
    "method": "sendTransaction",
    "params": [
      "<base64_encoded_tx_2>",
      { "encoding": "base64" }
    ]
  },
  {
    "jsonrpc": "2.0",
    "id": 3,
    "method": "sendTransaction",
    "params": [
      "<base64_encoded_tx_3>",
      { "encoding": "base64" }
    ]
  }
]'

const response = await fetch('https://STELLIUM_ENDPOINT/$APIKEY', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify([
    {
      jsonrpc: '2.0',
      id: 1,
      method: 'sendTransaction',
      params: [
        base64EncodedTx1,
        { encoding: 'base64' }
      ]
    },
    {
      jsonrpc: '2.0',
      id: 2,
      method: 'sendTransaction',
      params: [
        base64EncodedTx2,
        { encoding: 'base64' }
      ]
    },
    {
      jsonrpc: '2.0',
      id: 3,
      method: 'sendTransaction',
      params: [
        base64EncodedTx3,
        { encoding: 'base64' }
      ]
    }
  ])
});

import requests
import uuid

response = requests.post(
    'https://STELLIUM_ENDPOINT/$APIKEY',
    json=[
        {
            'jsonrpc': '2.0',
            'id': 1,
            'method': 'sendTransaction',
            'params': [
                base64_encoded_tx1,
                {'encoding': 'base64'}
            ]
        },
        {
            'jsonrpc': '2.0',
            'id': 2,
            'method': 'sendTransaction',
            'params': [
                base64_encoded_tx2,
                {'encoding': 'base64'}
            ]
        },
        {
            'jsonrpc': '2.0',
            'id': 3,
            'method': 'sendTransaction',
            'params': [
                base64_encoded_tx3,
                {'encoding': 'base64'}
            ]
        }
    ]
)

Parameters

Each request object in the batch array contains:

Parameter	Type	Description
`jsonrpc`	string	Must be “2.0”
`id`	number/string	Unique identifier for the request (UUID is a unique ID generated by the user for request identification)
`method`	string	Must be “sendTransaction”
`params`	array	Array containing the transaction and encoding options
`params[0]`	string	The transaction encoded in base64 format
`params[1].encoding`	string	Must be ‘base64’

Response

The response is an array of JSON-RPC response objects, one for each request in the batch. Responses are returned in the same order as the requests:

[
  {
    "jsonrpc": "2.0",
    "result": "transaction_signature_1",
    "id": 1
  },
  {
    "jsonrpc": "2.0",
    "result": "transaction_signature_2",
    "id": 2
  },
  {
    "jsonrpc": "2.0",
    "result": "transaction_signature_3",
    "id": 3
  }
]

[
  {
    "jsonrpc": "2.0",
    "result": "transaction_signature_1",
    "id": 1
  },
  {
    "jsonrpc": "2.0",
    "error": {
      "code": error_code,
      "message": "Error description"
    },
    "id": 2
  },
  {
    "jsonrpc": "2.0",
    "result": "transaction_signature_3",
    "id": 3
  }
]

Important Notes

Each transaction in the batch requires a system transfer instruction to one of the Stellium tip addresses with a minimum tip of 0.001 SOL.
Rate limits apply to the total number of transactions sent by your API key, regardless of whether transactions are sent individually or in batches.
For optimal transaction landing, alternate between different tip addresses for consecutive transactions in the batch.
Each request in the batch must have a unique id value to match responses correctly.
Responses are returned in the same order as the requests in the batch array.
Individual requests in a batch can succeed or fail independently - check each response object for success or error status.

API Documentation

Endpoints

Request Format

Parameters

Response

Important Notes

​Request Format

​Parameters

​Response

​Important Notes

Request Format

Parameters

Response

Important Notes