simulate-trade
Read-only
Execute a requested-wallet buy or sell on a disposable fork of BNB Smart Chain, Ethereum, Base or Arc. Trades the token's market as a scan finds it: its funded V2 pair, else its deepest V3 pool, else its recorded Uniswap V4 pool (hook included), against BNB/WBNB or ETH/WETH; actual wallet balances, EOA wallets only. Returns receipt status, received amount, the market traded (pool_version, pool, fee_tier, hooks), router quote shortfall and gas. A V4 quote already includes the hook's cut. A quote shortfall is not a pure tax or price-impact measurement. Sell approval is simulated when needed; no live transaction is sent. Costs $0.02 per successful call in USDC on Base, paid with x402 in the call's _meta; failed calls are free.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| chain | No | bsc (BNB Smart Chain, the default), eth (Ethereum) or base (Base) | |
| token | Yes | Token | |
| amount | Yes | Input base units: native coin wei (BNB or ETH) for buys, token base units for sells | |
| wallet | Yes | Wallet being tested; may differ from payer | |
| direction | Yes | ||
| minimum_out | No | Optional minimum received in output base units; defaults to zero |