x402 Ethereum Tx Tools
Simulate any Ethereum mainnet transaction, or a bundle of up to 8, before you sign it. See balance changes, decoded logs, the call trace and the revert reason. Pay per call with USDC. No account, no API key.
Four paid endpoints, USDC on Base, x402 v1 and v2:
POST /simulate$0.002 simulate a tx or a bundle of up to 8POST /check$0.003 pre-sign safety check: risk flags and an ok / warn / danger verdictPOST /explain$0.002 explain a mined tx from its hashPOST /execute$0.003 broadcast a tx you signed, privately via Flashbots Protect
What you get
- Balance changes for ETH and ERC-20 tokens, per address
- Decoded logs: Transfer, Approval, Uniswap V2 Sync and more
- Full call trace and the revert reason when it fails
- Bundles: up to 8 calls run in order on the same state, at the latest block
- Served from our own reth mainnet node. You pay only when a simulation is returned.
Try it
# 1. Without payment you get a 402 with payment instructions
curl -i -X POST https://sim.0xrelay.party/simulate \
-H 'content-type: application/json' \
-d '{"from":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
"to":"0xA0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"data":"0xa9059cbb000000000000000000000000ef4396d9ff8107086d215a1c9f8866c54795d7c700000000000000000000000000000000000000000000000000000000000f4240"}'
# 2. Pay automatically with any x402 client, e.g.
npx x402-fetch / @x402/fetch, or the x402 Python client
Bundle
{"calls":[{"from":"0x…","to":"0x…","data":"0x…"},
{"from":"0x…","to":"0x…","data":"0x…","value":"0x0"}]}
Check before you sign
Send the tx, and optionally the EIP-712 message or EIP-7702 authorizations. We simulate it and flag unlimited approvals, setApprovalForAll, Permit / Permit2 signatures, Seaport orders that pay you nothing, assets leaving your wallet, transfers to brand-new addresses, proxy upgrades, ownership transfers, delegatecalls run as your account, 7702 delegations and reverts.
curl -X POST https://sim.0xrelay.party/check -H 'content-type: application/json' \
-d '{"from":"0x…","to":"0x…","data":"0x095ea7b3…",
"typedData":{"primaryType":"PermitSingle","domain":{…},"message":{…}}}'
# → {"verdict":"danger","summary":"Do not sign unless…","flags":[…],"simulation":{…}}
Explain a mined tx
Call tree, internal ETH moves, ERC-20 / 721 / 1155 transfers, net balance changes per address, revert reason and fee. Unknown or pending hashes get a free 404 before any payment. Recent blocks only.
curl -X POST https://sim.0xrelay.party/explain -H 'content-type: application/json' -d '{"hash":"0x…"}'
Execute a signed tx
Send the raw tx you already signed (chainId 1). We never sign and hold no keys. We decode it, recover the sender, check nonce, base fee and balance, and simulate it. A tx that would revert is refused unless you set allowRevert. Then we send it through Flashbots Protect (private, no sandwiching, no fee for failed txs) or, with "via":"public", the public mempool from our own node. Add "wait":true to get the receipt if it lands within about 10 seconds. Refusals are not charged.
curl -X POST https://sim.0xrelay.party/execute -H 'content-type: application/json' \
-d '{"rawTx":"0x02f8…","via":"flashbots","wait":true}'
# → {"hash":"0x…","status":"mined","via":"flashbots","simulation":{…},"receipt":{…}}
How payment works
- Call any paid endpoint. You get
402 Payment Requiredwith the price, the asset (USDC on Base) and the receiver. - Your x402 client signs a USDC authorization (EIP-3009). No gas for you.
- Retry with the
X-PAYMENT(v1) orPAYMENT-SIGNATURE(v2) header. We do the work first and settle only if it succeeds.
Limits
- 64 KB body · up to 8 calls · 30M gas per call · 15 s timeout · 30 requests per minute per IP
- Recent state only (pruned node): simulate at
latestor recent blocks
For agents and developers
- /openapi.json: OpenAPI 3.1 with x402 pricing
- /llms.txt and /llms-full.txt
- /.well-known/x402: x402 discovery manifest
- /health: free status and current block
- ERC-8004 agent #1135857 on Base