Aqua Builder is an independent block builder on Ethereum mainnet. Searchers and wallets can send bundles and private transactions directly to the builder. We include them in the blocks we build every slot and submit to MEV-Boost relays.
https://rpc.aquabuilder.online
| Transport | HTTPS POST, JSON-RPC 2.0, path /, header Content-Type: application/json |
|---|---|
| Methods | eth_sendBundle, eth_cancelBundle, eth_callBundle (simulation), mev_sendBundle, eth_sendRawTransaction, eth_sendPrivateTransaction, aqua_getBundleStats (bundle tracing; aliases flashbots_getBundleStatsV2, flashbots_getBundleStats) |
| Read methods | eth_call, eth_blockNumber, eth_getBalance, eth_getTransactionReceipt, eth_estimateGas and the other standard reads are proxied to the execution client so a wallet can use this URL as its network RPC. eth_getLogs is limited to 10 blocks and eth_feeHistory to 64. GET returns 405. In mev_sendBundle, hash (backrun) body entries are not supported because Aqua runs no MEV-Share matchmaker/hint stream; send the full signed transaction. |
| Batch | Up to 10 requests per JSON-RPC batch. Each item is validated separately (including the refund requirement); invalid items get their own error, valid ones are forwarded |
| Network | Ethereum mainnet only |
curl -s https://rpc.aquabuilder.online \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"eth_sendBundle","params":[{"txs":[]}]}'
Expected response: {"jsonrpc": "2.0", "id": 1, "error": {"code": -32602, "message": "empty bundle"}}
An empty txs list is rejected by the gateway, so this only confirms the endpoint is reachable. A bundle with at least one valid signed transaction returns {"jsonrpc":"2.0","id":1,"result":{"bundleHash":"<bundle hash>"}}. Malformed bundles get a JSON-RPC -32602 error that names the problem (for example txs[0]: failed to decode/recover transaction).
Runnable reference clients that handle signing, the refund fields and simulation:
| Python | searcher_quickstart.py — pip install requests eth-account |
|---|---|
| TypeScript | searcher_quickstart.ts — npm i ethers, run with npx tsx |
Both expose the same four operations:
# reachability check (expects -32602 "empty bundle")
python3 searcher_quickstart.py connectivity
# simulate before sending
python3 searcher_quickstart.py call-bundle --raw-tx 0x... --block 26366643
# send with a refund
AQUA_SIGNER_KEY=0x... AQUA_REFUND_RECIPIENT=0x... \
python3 searcher_quickstart.py send-bundle \
--raw-tx 0x... --block 26366643 --refund-percent 25
# track it
python3 searcher_quickstart.py stats --bundle-hash 0x...
The clients also include refund_amount() and
effective_builder_payment() helpers: the amount refunded is
coinbase_profit × refundPercent / 100, and the builder keeps the rest.
Unit tests for the validation and refund math live in test_searcher_quickstart.py.
Submit an ordered list of signed transactions to be included atomically in a target block.
| Field | Description |
|---|---|
txs | Array of signed raw transactions (hex strings), executed in order |
blockNumber | Target block number (hex string). The bundle is only considered for this block |
minTimestamp, maxTimestamp | Optional. Unix seconds; bundle is valid only within this window |
revertingTxHashes | Optional. Hashes of transactions in txs that are allowed to revert |
replacementUuid | Optional. UUID v4 you choose; a later bundle with the same UUID replaces this one, and it can be cancelled with eth_cancelBundle. Requires a valid X-Flashbots-Signature (replacement is scoped to your signing address, so nobody else can replace or cancel your bundle); unsigned requests with a UUID get -32602. uuid is accepted as an alias. |
replacementNonce | Optional, used with replacementUuid. Non-negative integer; the bundle with the highest nonce for a UUID wins. If omitted the gateway assigns an increasing nonce (arrival time in microseconds), so the latest bundle you send replaces earlier ones. |
replacementSeqNumber | Optional, same as replacementNonce (Quasar/Titan name). Monotonically increasing number for bundles that share a replacementUuid; a bundle with a lower number than one already received is ignored. 0 or omitted: ordering falls back to arrival time. Sending both with different values returns -32602. Do not mix explicit numbers with omitted ones on the same UUID: arrival-time values are much larger and always win. |
droppingTxHashes | Optional. Hashes of transactions in txs that may be left out of the block (for example if their nonce is already used), but may not revert on chain. Each hash must belong to this bundle, otherwise -32602. Not allowed with "version": "v1". |
refundTxHashes | Optional, at most one hash. The transaction the refund is calculated from; default is the last transaction of the bundle. Must belong to this bundle. Not allowed with "version": "v1". |
refundPercent | Optional. Integer 0–99: percentage of the bundle's coinbase profit refunded in-block. Omitted together with refundRecipient means 0 |
refundRecipient | Address string (<address>) that receives the refund. Optional. If both refundPercent and refundRecipient are omitted, the gateway records refundPercent: 0 (no payout). A present refundPercent must be an integer 0..99 |
signingAddress | Set by the gateway from a verified X-Flashbots-Signature. A value you put in the body is ignored unless it matches the verified signer. |
curl -s https://rpc.aquabuilder.online \
-H 'Content-Type: application/json' \
-H 'X-Flashbots-Signature: <address>:<signature>' \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "eth_sendBundle",
"params": [{
"txs": ["<signed raw tx hex>", "<signed raw tx hex>"],
"blockNumber": "<target block number, hex>",
"revertingTxHashes": [],
"refundPercent": 10,
"refundRecipient": "<address>",
"replacementUuid": "9f6c1a2e-4b7d-4c1e-9a3f-2d5e8b7c6a10"
}]
}'
Response: {"jsonrpc":"2.0","id":1,"result":{"bundleHash":"<bundle hash>"}} means the bundle passed validation and was handed to the builder for simulation. Acceptance does not guarantee inclusion. Validation errors return a JSON-RPC error object instead of null. A bundle that omits both refund fields is accepted and stored as refundPercent: 0. Blob (type 3) transactions are not supported in bundles.
Submit a bundle in Flashbots MEV-Share v0.1 format. The gateway translates it into eth_sendBundle for the target block range (max 30 blocks). This is a direct submission to Aqua; Aqua is not a Flashbots MEV-Share matchmaker participant and does not forward to other builders.
| Field | Description |
|---|---|
version | Must be "v0.1" or "beta-1" |
inclusion.block | Target block number (hex string). The bundle is considered for this block and, if maxBlock is set, for each block up to maxBlock (inclusive) |
inclusion.maxBlock | Optional. Upper bound (hex). Must be ≤ block + 30. Each block in the range generates a separate internal eth_sendBundle |
body | Array of objects. Each entry must be {"tx": "<signed raw tx hex>", "canRevert": bool}. Entries of type {"hash": ...} (backrun) and nested {"bundle": ...} are rejected |
validity.refund | Optional. At most one entry: {"bodyIdx": int, "percent": int 0..99}. Maps to Aqua's refundPercent. If neither this nor validity.refundConfig is set, the bundle is stored as refundPercent: 0 |
validity.refundConfig | Optional, exactly one address if present: {"address": "<address>", "percent": int}. Maps to Aqua's refundRecipient. If omitted, the refund goes to the verified X-Flashbots-Signature signer, otherwise to the first transaction sender |
privacy, metadata | Ignored. Aqua never shares hints and never forwards to other builders |
curl -s https://rpc.aquabuilder.online \
-H 'Content-Type: application/json' \
-H 'X-Flashbots-Signature: <address>:<signature>' \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "mev_sendBundle",
"params": [{
"version": "v0.1",
"inclusion": {"block": "<target block number, hex>", "maxBlock": "<optional, hex>"},
"body": [
{"tx": "<signed raw tx hex>", "canRevert": false}
],
"validity": {"refund": [{"bodyIdx": 0, "percent": 10}]}
}]
}'
Response: {"jsonrpc":"2.0","id":1,"result":{"bundleHash":"<bundle hash>"}} means the bundle passed validation and was handed to the builder for simulation. Acceptance does not guarantee inclusion. Limits: maxBlock ≤ block + 30; hash and nested bundle entries are rejected; validity.refund at most one entry; privacy and metadata are ignored. A mev_sendBundle without a refund field is stored as refundPercent: 0.
Cancel a previously sent bundle by its replacementUuid. The request must carry a valid X-Flashbots-Signature from the same key that sent the bundle; unsigned cancels are rejected with -32602. Sending eth_sendBundle with the same signed UUID and an empty txs list also cancels.
curl -s https://rpc.aquabuilder.online \
-H 'Content-Type: application/json' \
-H 'X-Flashbots-Signature: <address>:<signature>' \
-d '{"jsonrpc":"2.0","id":1,"method":"eth_cancelBundle","params":[{"replacementUuid":"9f6c1a2e-4b7d-4c1e-9a3f-2d5e8b7c6a10"}]}'
Response: {"jsonrpc":"2.0","result":null,"id":1}. Cancellation is best effort. A bundle already in a submitted block cannot be recalled.
Simulate a bundle on top of a given state, in the standard Flashbots format, before you send it. Nothing is sent to the builder and nothing is stored. The request must carry a valid X-Flashbots-Signature (any key you control); unsigned requests are rejected with -32602. One bundle per request (no batches), at most 16 transactions.
curl -s https://rpc.aquabuilder.online \
-H 'Content-Type: application/json' \
-H 'X-Flashbots-Signature: <address>:<signature>' \
-d '{"jsonrpc":"2.0","id":1,"method":"eth_callBundle","params":[{"txs":["<signed raw tx hex>"],"blockNumber":"<hex target block>","stateBlockNumber":"latest"}]}'
| Field | Description |
|---|---|
txs | Required. 1–16 signed raw transactions (no blob transactions). |
blockNumber | Required. Hex block number the bundle would be included in (usually head + 1). |
stateBlockNumber | Optional. Hex block number or "latest" (default) to simulate on. |
timestamp | Optional. Integer unix timestamp for the simulated block. |
Response: the standard Flashbots result (bundleGasPrice, bundleHash, coinbaseDiff, ethSentToCoinbase, gasFees, results, stateBlockNumber, totalGasUsed). A transaction that cannot execute (bad nonce, insufficient funds) returns a JSON-RPC error with the reason. Limits: 2 requests/s per IP and per signing key; when the simulator is busy you get HTTP 429 -32005 simulation busy, retry.
Look up what happened to a bundle using the bundleHash returned by eth_sendBundle / mev_sendBundle. Send it to the same endpoint, https://rpc.aquabuilder.online. No signature needed. Data is kept for 24 hours. The final status is ready about 2 blocks after the target block (or after maxBlock for mev_sendBundle). bundle_hash is accepted as an alias.
curl -s https://rpc.aquabuilder.online \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"aqua_getBundleStats","params":[{"bundleHash":"<bundle hash>"}]}'
Response:
{"jsonrpc":"2.0","id":1,"result":{
"bundleHash":"0x…","status":"Landed","error":null,
"receivedAt":1793546170,"lastReceivedAt":1793546170,"receivedCount":1,
"targetBlock":26320756,"maxTargetBlock":null,"blockNumber":26320756,"landedByAqua":true,
"minTimestamp":null,"maxTimestamp":null,"replacementSeqNumber":5,
"builderPayment":null,"simulatedAt":null,"submittedAt":null,"traceSource":"gateway+chain"}}
| Status | Meaning |
|---|---|
Received | Accepted by the gateway and handed to the builder. The target block is not final yet. note says why. |
Invalid | Rejected (see error). Fix the bundle format. |
Replaced | A bundle with the same replacementUuid and a higher replacementSeqNumber replaced this one. |
Cancelled | Cancelled with eth_cancelBundle (or an empty-txs bundle with the same UUID) after it was received. |
Landed | The bundle's transactions (except droppingTxHashes) landed together in an Aqua Builder block within the target range. |
LandedElsewhere | The transactions landed together, but in a block built by another builder or outside the target range. |
NotIncluded | The target block passed and the bundle did not land. If some of its transactions landed on their own, note says so. |
Simulation and block-building stages (SimulationFail, SimulationPass, ExcludedFromBlock, IncludedInBlock, Submitted) and builderPayment are not available yet. They return null until builder-side tracing ships. Errors: unknown hash -32001, malformed hash -32602, and aqua_getBundleStats cannot be mixed with send methods in one batch (-32600).
flashbots_getBundleStatsV2 and flashbots_getBundleStats are accepted as aliases so existing Flashbots clients can call it unchanged. They take the same {"bundleHash": …} parameter (blockNumber is ignored) and return the Aqua response shown above, not the Flashbots relay schema.
Send a single signed transaction privately to the builder. It is not broadcast to the public mempool by us.
curl -s https://rpc.aquabuilder.online \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"eth_sendRawTransaction","params":["<signed raw tx hex>"]}'
Flashbots-compatible form of eth_sendRawTransaction: params: [{"tx": "<signed raw tx hex>"}]. The transaction goes privately to the builder only. maxBlockNumber and preferences are accepted but ignored; eth_cancelPrivateTransaction is not supported.
curl -s https://rpc.aquabuilder.online \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"eth_sendPrivateTransaction","params":[{"tx":"<signed raw tx hex>"}]}'
You may add the header X-Flashbots-Signature: <address>:<signature> in the
standard Flashbots format (an EIP-191 signature of the keccak256 hash of the request body,
made with any key you control). It is optional for plain bundles and raw transactions, and required for replacementUuid, eth_cancelBundle and eth_callBundle.
When present it is verified and the signing address is used as a stable searcher identity
for rate-limit and abuse handling and for refund attribution. Use a dedicated
signing key, not a key that holds funds.
| Limit | Value | When exceeded |
|---|---|---|
| Request body | 1 MB | HTTP 413 |
| Request rate | 20 requests/s per IP (burst 50) | HTTP 429 |
| Cancellations | 5 eth_cancelBundle per second per IP | HTTP 429, JSON-RPC -32005 |
| Simulation | 2 eth_callBundle per second per IP and per signing key, 16 txs per bundle | HTTP 429, JSON-RPC -32005 |
| Bundle tracing | 10 aqua_getBundleStats per second per IP | HTTP 429, JSON-RPC -32005 |
| Connections | 30 concurrent per IP | HTTP 429 |
| Batch size | 10 requests | Rejected |
On HTTP 429, back off briefly (for example 100–250 ms with jitter) and retry. If you need higher limits, contact us.
Transactions to, from or touching OFAC-sanctioned addresses are filtered, including inside bundles. A bundle containing such a transaction is not included.
Refunds: 91% of a searcher bundle's marginal contribution to the block value, only for blocks Aqua Builder wins and that are finalized (64 confirmations), capped at 91% of the builder's net profit for that block (at least 9% stays with the builder; pro-rata across bundles if the cap applies; payouts never exceed the block profit minus gas). No subsidy: Aqua Builder never bids above a block's real value, so refunds never come out of the builder's own funds. refundPercent and refundRecipient are optional. If both are omitted (and a mev_sendBundle omits validity.refund / validity.refundConfig), the bundle is stored as refundPercent: 0 and no refund is owed. In-block refunds are deducted when a percent is set. Rate may be adjusted; changes will be announced on this page.
Payouts run automatically every day at 00:30 UTC (03:30 Europe/Istanbul) as a single on-chain batch when that is cheaper. Minimum payout is 0.0001 ETH per item (for plain transfers, also at least the transfer gas cost); smaller amounts are not sent. Settlement uses the BatchRefund contract 0x69250877f52fC8B3c53E95A421Ab75b4F476A7CC (owner: the refund wallet). A run with one to four existing (EOA) recipients is paid as ordinary 21 000-gas transfers; five or more EOA recipients, or any contract recipient, go through disperse() in one transaction so contract recipients are included. If a recipient call fails, that amount is held for a later run and does not revert the rest of the batch. The public refund ledger lists every payout transaction.
Check your refunds: on the home page, open Refunds paid and enter the wallet that receives refunds. You can also read Refund owed (ETH) and Last payout (UTC) there.
Aqua Builder's operator also runs its own trading bots. Because of that, we make these commitments about flow sent to rpc.aquabuilder.online:
/api/stats.json (own_bot_bundles), so the numbers are never mixed.If you believe a bundle you sent to Aqua was copied or exploited, email contact@aquabuilder.online with the bundleHash and block. We will investigate and publish the result on this page.
https://aquabuilder.online/api/stats.json (same content at /stats.json), refreshed every 10 minutes, no key needed. The orderflow object describes flow received on rpc.aquabuilder.online:
Field (orderflow.windows.24h / 7d) | Meaning |
|---|---|
bundles_received_external | Bundles received from third-party searchers |
bundles_accepted_external, acceptance_rate | Bundles that passed validation and were handed to the builder |
unique_external_senders | Distinct third-party senders |
own_bot_bundles | Bundles from the operator's own bots (counted separately) |
gateway_latency_ms | p50 / p90 / p99 time from gateway receive to builder accept (excludes your network round trip) |
rate_limited_requests, cancels, target_blocks, bundles_per_block_avg, bundles_in_won_blocks | Rate-limit hits, cancellations, distinct target blocks, average bundles per target block, bundles in blocks Aqua won |
Top-level fields: blocks_won_count, blocks_won, refund_owed_eth_total, refund_paid_eth_total, orderflow.refund_share_percent, bids_submitted and relay_stats (per-relay submissions, errors and status). Per-bundle status: aqua_getBundleStats.
| Network | Ethereum mainnet (live) |
|---|---|
| Relays configured | FlashbotsUltra SoundTitanAgnosticAestusETHGasbloXroute Regulated |
| Relay endpoints | boost-relay.flashbots.net, relay-builders-eu.ultrasound.money, eu-global.titanrelay.xyz, agnostic-relay.net, aestus.live, relay.ethgas.com, bloxroute.regulated.blxrbdn.com. Aestus, ETHGas and bloXroute Regulated were added in November 2026; per-relay submission status (live / down / no data) is shown on the home page. |
| Block extra data | Aqua Builder |
| Live stats | Blocks won, bids, slots, relays, Refund owed, and Refunds paid (wallet lookup) are on the home page. Machine-readable: /api/stats.json (see Trust & stats). |
| Blocks won table | Block, slot, relay, paid to proposer, refund owed; B↗ / E↗ explorer links. Scrolls after 20 wins. |
Maintenance and changes to this API are announced on this page.
Bundles & inquiries: contact@aquabuilder.online
blockNumber was in the past, or the timestamp window had passed.revertingTxHashes, or a nonce or balance changed.Refunds: 91% of a bundle's marginal contribution in blocks Aqua Builder wins, capped at 91% of the builder's profit for that block; paid daily at 00:30 UTC, minimum payout 0.0001 ETH, no subsidy. See OFAC & refunds.
The next block (current head + 1). Send the same bundle to several upcoming blocks if you want more chances.
Bundles & inquiries: contact@aquabuilder.online · Home