{"uid":"cap_ZECnAat_AsF-dW7iuhtDE","slug":"zerion-api-wallet-transaction-simulation-c996c13f","name":"Zerion API - Wallet Transaction Simulation","description":"Interpreted wallet data for more than 40 chains and Solana: portfolios, DeFi positions, PnL, transactions and NFTs. REST for apps, x402 pay-per-call for agents.","url":"https://api.zerion.io/v1/wallets/simulation/transaction?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"address":{"type":"string","description":"Wallet address"},"chain_id":{"type":"string","description":"Chain ID"},"transaction":{"type":"object","description":"Transaction to simulate"}}},"responseSchema":{"type":"json","example":{"data":{"id":"<resource id>","type":"<resource type>","attributes":{}},"links":{"self":"https://api.zerion.io/v1/..."}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_SyhK0teZu6HyPQO32KROO","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Simulates a blockchain transaction for a given wallet and chain, returning predicted outcomes before execution","exampleAgentPrompt":"Before I submit this swap transaction on Ethereum mainnet (chain ID 1), can you simulate it for my wallet 0xAbC...123 and tell me what the expected outcome will be — token changes, approvals, and whether it's likely to succeed?","exampleUseCases":[{"title":"Pre-flight DeFi swap check","prompt":"I'm about to swap 1 ETH for USDC on Uniswap using wallet 0xAbC...123 on Ethereum (chain ID 1) — can you simulate that transaction first so I can see if it'll go through and what I'll actually receive?"},{"title":"Safe NFT purchase preview","prompt":"Before I buy this NFT, simulate the purchase transaction for my wallet 0xDef...456 on Polygon (chain ID 137) so I can confirm the expected changes to my holdings and whether the transaction will succeed."},{"title":"Approval transaction validation","prompt":"I need to approve a DeFi protocol to spend my USDC — can you run a simulation of that approval transaction for wallet 0x789...abc on Arbitrum (chain ID 42161) to make sure it looks safe before I sign it?"}],"resultDescription":"Returns a JSON object with a data field containing a resource id, resource type, and attributes describing the predicted outcome of the simulated transaction — including expected state changes, token flows, and success/failure indicators — along with a self-referencing links object.","failureModes":["Invalid wallet address format returns 400 bad request","Unsupported chain ID returns 422 or error response","Malformed transaction object causes simulation failure","Network congestion or RPC timeout may cause 503","Insufficient input fields (missing address or transaction) returns 400","Transaction simulation itself may return a reverted/failed state in attributes"],"whenToPreferThis":"Use this endpoint when an AI agent or app needs to preview the outcome of a blockchain transaction before committing it on-chain — especially for DeFi swaps, NFT purchases, token approvals, or any high-stakes transaction where verifying expected results and safety is critical. Prefer this over live execution when the goal is risk assessment or user confirmation flows.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-01T06:33:00.802Z","isFirstParty":false,"canonicalSlug":"zerion-api-wallet-transaction-simulation-c1d8f1d6"}