{"uid":"cap_tqSoHiW8jYHBuU52vwuKH","slug":"base-transaction-simulator-x402-beb3bcf8","name":"Base Transaction Simulator (x402)","description":"Pay-per-call crypto microdata for trading/onchain AI agents via x402 (USDC on Base): Base gas, token risk, balances, multi-venue prices, Hyperliquid book/funding, kimchi premium. No API keys.","url":"https://kr-x402-mvp.kgy5612.workers.dev/v1/simulate?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{"to":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","examples":["0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"],"description":"Target contract or recipient"},"data":{"type":"string","pattern":"^0x([0-9a-fA-F]{2})*$","description":"Calldata (default 0x)"},"from":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","examples":["0xe4be4d0bd82d8e68203deff81f79ede0529f2617"],"description":"Sender (signer) address"},"calls":{"type":"string","description":"URL-encoded JSON array of up to 5 {to,data,value_eth|value} run in order from the same sender"},"value_eth":{"type":"string","examples":["0.01"],"description":"ETH to send, decimal (default 0)"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"from":"0xe4be4d0bd82d8e68203deff81f79ede0529f2617","next":["/crypto/base-gas","/crypto/tx-status?hash="],"block":53272234,"calls":[{"to":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","index":0,"success":true,"function":"transfer(address,uint256)","gas_used":45047,"revert_reason":null}],"chain":"base","flags":[],"fee_eth":5e-7,"fee_usd":0.0019,"success":true,"summary":"1 call succeeds; sender sends 0.001 USDC","verdict":"SAFE_TO_SEND","approvals":[],"transfers":[{"to":"0xa587d73489f8f09d1975f1ddbb1c61c93e8fa9d7","from":"0xe4be4d0bd82d8e68203deff81f79ede0529f2617","token":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","amount":0.001,"symbol":"USDC"}],"gas_used_total":45047,"sender_changes":{"USDC":-0.001},"balance_changes":{"0xa587d73489f8f09d1975f1ddbb1c61c93e8fa9d7":{"USDC":0.001},"0xe4be4d0bd82d8e68203deff81f79ede0529f2617":{"USDC":-0.001}}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Xei-ZFf1pi_CoXBMwxrkL","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Simulates one or more Ethereum calldata transactions on Base, returning gas usage, token transfers, balance changes, and a SAFE/UNSAFE verdict before execution.","exampleAgentPrompt":"Before I send this USDC transfer on Base, simulate the transaction from 0xe4be4d0bd82d8e68203deff81f79ede0529f2617 calling 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 with calldata 0xa9059cbb...0001 and tell me if it's safe, what it'll cost in gas, and what token balances will change.","exampleUseCases":[{"title":"Pre-flight DeFi swap safety check","prompt":"I'm about to execute a Uniswap swap on Base from my wallet 0xe4be4d0bd82d8e68203deff81f79ede0529f2617 to the router at 0x2626664c2603336E57B271c5C0b26F421741e481 with this calldata. Simulate it first and tell me if it'll succeed, how much gas it burns, and what tokens move."},{"title":"Batch transaction preview","prompt":"I have 3 Base transactions I want to run in sequence from address 0xe4be4d0bd82d8e68203deff81f79ede0529f2617 — can you simulate all of them together and tell me the total fee in USD and whether any of them revert?"},{"title":"Suspicious calldata audit","prompt":"Someone just sent me a transaction request asking me to call contract 0xabcdef1234567890abcdef1234567890abcdef12 on Base with some calldata I don't recognize. Simulate it from my address 0xe4be4d0bd82d8e68203deff81f79ede0529f2617 and tell me exactly what tokens or approvals it would trigger — is it safe to send?"}],"resultDescription":"Returns a JSON object with: overall success/fail verdict (SAFE_TO_SEND or unsafe), decoded function name, gas used per call and total, fee in ETH and USD, list of token transfers (from/to/amount/symbol), per-address balance changes, approval events, revert reasons if any, current Base block number, and suggested next API endpoints.","failureModes":["Invalid address format returns 400 with schema validation error","Reverted simulation returns success:false with revert_reason populated","Malformed calldata hex rejected with parse error","More than 5 calls in batch array rejected","x402 payment not provided or insufficient returns 402 Payment Required","Network timeout on Base RPC node returns 5xx"],"whenToPreferThis":"Use this endpoint when you need to pre-flight a Base chain transaction before committing — especially for DeFi operations, token transfers, or unknown contract calls where you want to verify safety, decode intent, and see exact token movements without spending gas. Prefer over raw eth_call when you want human-readable transfer summaries, USD fee estimates, and a SAFE/UNSAFE verdict in one call. Requires only $0.003 USDC via x402, no API key setup.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:41:42.753Z","isFirstParty":false,"canonicalSlug":"base-transaction-simulator-x402-beb3bcf8"}