{"uid":"cap_jKeUVcQnWKNvyOk6A2FLZ","slug":"zerion-api-wallet-transaction-simulation-c1d8f1d6","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/transactions?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","required":["address"],"properties":{"address":{"type":"string","description":"Wallet address (EVM 0x or Solana base58)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["data"],"properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Resource ID."},"type":{"type":"string","description":"Resource type."},"attributes":{"type":"object","description":"Resource attributes; see https://developers.zerion.io"}}},"description":"Array of JSON:API resource objects."},"links":{"type":"object","description":"Self and pagination links."}}}}}}},"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_sfLLj-inaFJalG-DBnly_","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 transactions for a given wallet address across 40+ EVM chains and Solana, returning interpreted simulation results before execution","exampleAgentPrompt":"Before I confirm this swap on my wallet 0x742d35Cc6634C0532925a3b8D4C9C6A7e2F1d23b, can you simulate the transaction and show me exactly what tokens I'll receive and what the impact on my portfolio will be?","exampleUseCases":[{"title":"DeFi swap safety check","prompt":"I'm about to do a big USDC-to-ETH swap from my wallet 0x742d35Cc6634C0532925a3b8D4C9C6A7e2F1d23b — can you simulate the transaction first so I can see the expected output and make sure nothing looks off before I sign?"},{"title":"Smart contract interaction preview","prompt":"Before I interact with this new DeFi protocol from my wallet 0xAb5801a7D398351b8bE11C439e05C5B3259aec9A, simulate the transaction and tell me what assets will leave my wallet and what I'll get back."},{"title":"NFT purchase validation","prompt":"I want to buy an NFT but want to make sure the transaction is safe first — can you simulate it for my Solana wallet GsbwXfJraMomNxBcpR3DBFpFpYSJVQUBqQRFpNFyHGxR and show me what will happen before I commit?"}],"resultDescription":"An array of JSON:API resource objects describing the simulated transaction outcome, including expected token transfers, portfolio changes, and transaction effects, along with pagination links. The response shows what would happen to the wallet if the transaction were executed, without actually submitting it to the blockchain.","failureModes":["Invalid or malformed wallet address returns 400 Bad Request","Unsupported chain or address format returns validation error","Payment required (402) if x402 micropayment header not included","Rate limiting or authentication errors (401/429) for unauthenticated requests","Simulation failure if transaction parameters are invalid or contract call would revert","Network timeouts for complex multi-step DeFi simulations"],"whenToPreferThis":"Use this endpoint when you need to preview or validate a blockchain transaction before it is submitted to the chain — particularly for high-value DeFi interactions, smart contract calls, or any scenario where the user wants to confirm expected token flows and portfolio impact without risking real funds. Prefer this over reading raw on-chain state when you need interpreted, human-readable simulation output across multiple chains in a single API call with pay-per-use x402 pricing.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-01T00:40:13.914Z","isFirstParty":false,"canonicalSlug":"zerion-api-wallet-transaction-simulation-c1d8f1d6"}