Raze.bot Developers

sendBundle

Submit a bundle of signed transactions via JSON-RPC. Bundles are forwarded to the Jito Block Engine for atomic execution.

Bundle constraints

Max 5 transactions if your bundle already includes a Jito tip transaction
Max 4 transactions if no Jito tip is included — the relay appends its own tip transaction as the 5th
At least 1 transaction required

If your bundle does not include a Jito tip, the relay automatically sponsors one and appends it.

Servers

Region	Endpoint
Frankfurt	`https://fra.send.raze.sh`
Amsterdam	`https://ams.send.raze.sh`
Chicago	`https://chi.send.raze.sh`
Singapore	`https://sg.send.raze.sh`

Request

POST /
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "sendBundle",
  "params": [
    [
      "<encoded_tx_1>",
      "<encoded_tx_2>"
    ],
    {
      "encoding": "base58"
    }
  ]
}

Field	Type	Required	Description
`params[0]`	string[]	Yes	Array of signed transactions (1–5)
`params[1].encoding`	string	No	`"base58"` (default, Jito-compatible) or `"base64"`

Response

Success — returns the Jito bundle ID:

{
  "jsonrpc": "2.0",
  "result": "4xTWpZFcQh8mK3nRJjz3wXBoRgixCa6xjnB7YaB1pPB263...",
  "id": 1
}

Error — returns an error object:

{
  "jsonrpc": "2.0",
  "error": {
    "code": -32602,
    "message": "bundle exceeds max size (5 transactions)"
  },
  "id": 1
}

Error code	Meaning
`-32700`	Parse error — invalid JSON
`-32602`	Invalid params — missing transactions, exceeds max bundle size, or malformed
`-32003`	Transaction rejected — tip below minimum

Code examples

curl
Node.js
Python
Rust

curl -X POST https://fra.send.raze.sh \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "sendBundle",
    "params": [
      ["<base58_tx_1>", "<base58_tx_2>"],
      {"encoding": "base58"}
    ]
  }'

const response = await fetch("https://fra.send.raze.sh", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    jsonrpc: "2.0",
    id: 1,
    method: "sendBundle",
    params: [
      [base58Tx1, base58Tx2],
      { encoding: "base58" },
    ],
  }),
});

const { result, error } = await response.json();
if (error) throw new Error(error.message);
console.log("Bundle ID:", result);

import requests

resp = requests.post("https://fra.send.raze.sh", json={
    "jsonrpc": "2.0",
    "id": 1,
    "method": "sendBundle",
    "params": [
        [base58_tx1, base58_tx2],
        {"encoding": "base58"},
    ],
})

data = resp.json()
if "error" in data:
    raise Exception(data["error"]["message"])
print("Bundle ID:", data["result"])

let client = reqwest::Client::new();
let resp = client
    .post("https://fra.send.raze.sh")
    .json(&serde_json::json!({
        "jsonrpc": "2.0",
        "id": 1,
        "method": "sendBundle",
        "params": [
            [base58_tx1, base58_tx2],
            {"encoding": "base58"}
        ]
    }))
    .send()
    .await?;

let body: serde_json::Value = resp.json().await?;
println!("Bundle ID: {}", body["result"]);

JSON-RPC Methods

​sendBundle

​Bundle constraints

​Servers

​Request

​Response

​Code examples