sendBundle submission is billed as 1 credit from your plan.
Supported Methods
| Method | Description | Rate Limit |
|---|---|---|
sendBundle | Submit a bundle | 5 RPS per project |
simulateBundle | Simulate a bundle without submitting | General RPC rate limit |
sendBundle
Submits a list of signed transactions as an atomic bundle. If the bundle is accepted, returns abundle_id (SHA-256 hash of the transaction signatures). This does not guarantee the bundle will land on-chain. Check for transaction confirmation on chain to verify.
A tip is required. At least one transaction must transfer SOL to a Helius tip account. If the tip is too low, the bundle may not be selected for inclusion.
Request
| Parameter | Type | Description |
|---|---|---|
params[0] | array[string] | Required. Up to 5 fully-signed transactions, base64 encoded. |
params[1].encoding | string | Optional. base64 (recommended) or base58. Default: base58. |
Example
Response
result is the bundle ID — use it with getBundleStatuses to track landing.
getBundleStatuses
Returns the status of submitted bundles. If a bundle has not landed or is not found, it returnsnull.
Request
| Parameter | Type | Description |
|---|---|---|
params[0] | array[string] | Required. Up to 5 bundle IDs. |
Example
Response
null in the value array for bundles not found.
Region Routing
By default, Helius routes your bundle to Jito’s global endpoint (mainnet.block-engine.jito.wtf), which geo-routes to the nearest Block Engine automatically.
To target a specific region, set the jito-region HTTP header:
| Header Value | Block Engine Region |
|---|---|
ams | Amsterdam |
dub | Dublin |
fra | Frankfurt |
lon | London |
nyc | New York |
slc | Salt Lake City |
sgp | Singapore |
tyo | Tokyo |
mainnet | Global (geo-routed) |
Example with Region
Tip Accounts
At least one transaction in your bundle must include a SOL transfer to one of these tip accounts. Pick one at random to reduce contention.Bundle Requirements
- Max 5 transactions per bundle
- All transactions must be fully signed
- Use base64 encoding (recommended over base58 for performance)
- At least one transaction must include a tip
- Transactions execute sequentially — tx2 can depend on state changes from tx1
simulateBundle (Optional)
You can optionally simulate your bundle before submitting to check for errors:See also
Transaction Rebates
Opt in on single
sendTransaction calls to earn a share of the MEV your transactions create, paid in SOL.