{"uid":"cap_4fpO20cLdQ4UIpT-Xhf2Z","slug":"base-transaction-simulator-tx-simulate-25458cd0","name":"Base Transaction Simulator (tx-simulate)","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/api/tx-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_yKfScGzxMRIUy--VtcgP4","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 Base chain transactions before sending, returning success/failure verdict, gas cost, token transfers, approval events, and balance changes.","exampleAgentPrompt":"Before I send this USDC transfer on Base — from 0xe4be4d0bd82d8e68203deff81f79ede0529f2617 to contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 with calldata 0xa9059cbb — can you simulate it and tell me if it'll succeed, how much gas it'll use, and what tokens will move?","exampleUseCases":[{"title":"Pre-flight check before DeFi swap","prompt":"I'm about to execute a swap on Base — sender is 0xe4be4d0bd82d8e68203deff81f79ede0529f2617, going to 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 with this calldata. Simulate it first and tell me if it's safe to send, what the gas cost will be in USD, and what my balance will look like after."},{"title":"Detect malicious contract before signing","prompt":"Someone sent me a transaction to sign on Base — to address 0x1234abcd... with some calldata. Can you simulate it and tell me the verdict: is it SAFE_TO_SEND? And show me every token approval and transfer it would trigger so I can verify nothing suspicious is happening."},{"title":"Simulate chained multicall on Base","prompt":"I want to run two contract calls back-to-back from my wallet 0xe4be4d0bd82d8e68203deff81f79ede0529f2617 on Base — first approve USDC, then swap. Simulate both as a sequence and tell me if they both succeed, what the total gas cost is, and what my final balances will be."}],"resultDescription":"Returns a JSON object with: overall success boolean, a SAFE_TO_SEND/REVERT verdict string, total gas used, fee in ETH and USD, a list of per-call results (success, function signature, gas used, revert reason if any), decoded token transfers with amounts and symbols, approval events, net balance changes per address per token, flags for anomalies, and links to related endpoints for next steps.","failureModes":["Invalid address format returns 400 validation error","Malformed calldata (odd-length hex) rejected at input validation","Sender with zero ETH/token balance may simulate a revert if the contract checks balances","Network timeout if Base RPC is congested","More than 5 calls in the multicall array rejected","Block state may be 1-2 blocks stale leading to minor gas estimation drift"],"whenToPreferThis":"Use this endpoint when an AI agent needs to pre-flight a Base transaction before submitting it — especially for DeFi interactions, token transfers, or any calldata the agent hasn't verified. It is uniquely suited for detecting reverts, decoding what a transaction actually does, previewing balance changes, and flagging suspicious approvals — all without spending gas. Choose it over a generic gas estimator when you need the full decoded picture of a transaction's effects, not just a gas number.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:42:05.100Z","isFirstParty":false,"canonicalSlug":"base-transaction-simulator-tx-simulate-25458cd0"}