What this does

This document describes Lunar Lander's /sendbundle endpoint for atomic bundle submission. The endpoint supports the following use case:

You submit multiple signed transactions as a single atomic bundle via JSON-RPC
All transactions in the bundle are executed sequentially — they all land or none are committed
Lunar Lander fans out the bundle to multiple block-engine relays for best landing probability

Endpoints

POST /sendbundle

Available at all regional endpoints:

https://fra.lunar-lander.hellomoon.io/sendbundle
https://ams.lunar-lander.hellomoon.io/sendbundle
https://nyc.lunar-lander.hellomoon.io/sendbundle
https://ash.lunar-lander.hellomoon.io/sendbundle
https://tyo.lunar-lander.hellomoon.io/sendbundle
https://lunar-lander.hellomoon.io/sendbundle (geolocated)

Requires Content-Type: application/json.

Note: This method is not enabled by default for all API keys. Contact us to activate bundle sending on your key.

Request Format

Use the sendBundle JSON-RPC method. The first parameter is an array of base64-encoded signed transactions.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "sendBundle",
  "params": [
    [
      "<base64_encoded_signed_tx_1>",
      "<base64_encoded_signed_tx_2>"
    ],
    {
      "encoding": "base64"
    }
  ]
}

params[0] — array of signed, serialized transactions encoded in base64
params[1].encoding — transaction encoding (use base64)

Validation And Limits

Maximum transactions per bundle: 4
Each transaction must be fully signed before submission
At least one transaction must include a tip to a Lunar Lander tip account
Tip minimum: 1,000,000 lamports (0.001 SOL)
All transactions must pass simulation — if any fails, the entire bundle is rejected

Response Contract

A successful response confirms the bundle was received and queued for submission. It does not guarantee on-chain landing.

{
  "jsonrpc": "2.0",
  "result": "ok",
  "id": 1
}

Status codes:

200 OK — bundle accepted and queued for submission
400 Bad Request — malformed transactions, missing tip, or bundle too large
403 Forbidden — API key does not have sendbundle scope enabled
429 Too Many Requests — rate limited

How `/sendbundle` differs from other send methods

	`/send`	`/sendBatch`	`/sendbundle`
Transactions per request	1	Up to 16	Up to 4
Execution	Individual	Individual (no atomicity)	Sequential and atomic
Wire format	JSON-RPC or binary	Binary (length-prefixed frames)	JSON-RPC
Tip required in	The transaction	The transaction	At least one transaction in the bundle

For details on /sendBatch, see the Batch Send API page.

Example

import requests
import base64

# Assume tx1 and tx2 are already signed Transaction objects
tx1_bytes = bytes(tx1.serialize())
tx2_bytes = bytes(tx2.serialize())

payload = {
    "jsonrpc": "2.0",
    "id": 1,
    "method": "sendBundle",
    "params": [
        [
            base64.b64encode(tx1_bytes).decode("utf-8"),
            base64.b64encode(tx2_bytes).decode("utf-8"),
        ],
        {"encoding": "base64"}
    ]
}

response = requests.post(
    "https://fra.lunar-lander.hellomoon.io/sendbundle?api-key=YOUR_KEY",
    json=payload,
)

print(response.json())

const tx1Base64 = Buffer.from(tx1.serialize()).toString("base64");
const tx2Base64 = Buffer.from(tx2.serialize()).toString("base64");

const response = await fetch(
  "https://fra.lunar-lander.hellomoon.io/sendbundle?api-key=YOUR_KEY",
  {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({
      jsonrpc: "2.0",
      id: 1,
      method: "sendBundle",
      params: [[tx1Base64, tx2Base64], { encoding: "base64" }],
    }),
  }
);

const result = await response.json();
console.log(result);

Frequently Asked Questions

Do I pay if my bundle doesn't land?

No. Tips are paid via transfer instructions within the bundle transactions. If the bundle doesn't land, no transactions execute and you pay nothing.

Can I check the status of my bundle?

Bundle status tracking is not currently available through Lunar Lander. We recommend confirming your transactions landed by checking the signatures on-chain via your preferred RPC endpoint.

What happens if one transaction in my bundle fails simulation?

The entire bundle is rejected. All transactions must pass simulation for the bundle to be submitted.