{"uid":"cap_PEpabeUqGfNU8SnL-c7z1","slug":"dopaminedesk-transaction-simulator-api-143ded16","name":"DopamineDesk Transaction Simulator API","description":"Run a read-only transaction simulation with eth_call and eth_estimateGas against a supported public EVM RPC without signing or broadcasting.","url":"https://ai-data-marketplace-1042299154756.us-central1.run.app/api/v1/tx_simulator","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":["network","from","to","data"],"properties":{"to":{"type":"string","description":"Destination contract address."},"data":{"type":"string","description":"Hex-encoded transaction calldata."},"from":{"type":"string","description":"Sender address."},"value":{"type":"string","description":"Amount of native token sent in wei."},"network":{"type":"string","description":"Blockchain network identifier."}},"additionalProperties":true}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["success","source","network","broadcast","simulation_status","estimated_gas","return_data","marketplace_metadata"],"properties":{"source":{"type":"string"},"network":{"type":"string"},"success":{"type":"boolean"},"broadcast":{"type":"boolean"},"return_data":{"type":"string"},"estimated_gas":{"type":"string"},"simulation_status":{"type":"string"},"marketplace_metadata":{"type":"object","required":["data_mode","billable","availability","source"],"properties":{"source":{"type":"string"},"billable":{"type":"boolean"},"data_mode":{"type":"string"},"availability":{"type":"string"}},"additionalProperties":true}},"additionalProperties":true}}}}},"responseSchema":{"type":"json","example":{"source":"base public JSON-RPC","network":"base","success":true,"broadcast":false,"return_data":"0x0000000000000000000000000000000000000000000000000000000000000006","estimated_gas":"30958","simulation_status":"SUCCESS","marketplace_metadata":"[object with keys: data_mode, billable, availability, source; full example in /openapi.json]"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_qG5Q9Ac5wRXEH3l6P5NfM","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","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 to predict revert status, gas usage, and token transfers before on-chain submission.","exampleAgentPrompt":"Before I submit this swap, simulate the transaction on Base — sender is 0xUser123, destination contract is 0xPool456, the calldata is 0xa9059cbb000...abcd, and I'm sending 0 wei. Will it revert, how much gas will it use, and what token transfers will happen?","exampleUseCases":[{"title":"Pre-flight DeFi swap check","prompt":"I'm about to execute a Uniswap swap on Base — can you simulate it first? Sender is 0xMyWallet, contract is 0xUniswapRouter, calldata is 0x38ed1739...deadbeef, and value is 0 wei. Tell me if it reverts and how much gas it'll consume."},{"title":"Smart contract security dry-run","prompt":"Before we deploy this interaction, simulate this contract call on Ethereum mainnet — from 0xDeployer, to 0xTargetContract, calldata 0x095ea7b3...feed, value 0. I want to confirm it won't revert and see any token movements it triggers."},{"title":"Validate airdrop calldata","prompt":"We're about to send a batch airdrop transaction on Base — sender 0xTreasury, contract 0xAirdropContract, calldata 0x1249c58b...cafe, value 0 wei. Can you dry-run it to make sure it won't revert and show me who receives tokens?"}],"resultDescription":"Returns a JSON object with a status field ('success' or 'failure'), a boolean indicating if the transaction reverts, the estimated gas_used, and an array of simulated_transfers showing each token movement (from address, to address, token type, and amount) that would occur if the transaction were executed on-chain.","failureModes":["Invalid or malformed hex calldata returns a parsing error","Unknown or unsupported network identifier results in a 400 error","Destination contract address does not exist on the specified network","Simulation infrastructure timeout for complex multi-call transactions","Missing required fields (to, data, network) causes validation failure","Insufficient context for simulation if dependent state is unavailable"],"whenToPreferThis":"Use this endpoint when you need to dry-run a blockchain transaction before committing it on-chain — especially for DeFi interactions, smart contract calls, or token transfers where revert risk or gas estimation matters. Prefer this over on-chain submission when safety validation, gas budgeting, or previewing token flows is the goal. It is particularly valuable in agentic pipelines where an AI must confirm transaction safety before executing a payment or contract interaction.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:53:40.353Z","isFirstParty":false}