Preview one trade priced across venues on several chains
Read-only. Discovers every venue offering the pair on every allowed chain, splits the size across them by best marginal price, and reports the combined result against the best single source. Places no capital hold and mints no signature. Sources whose chain has no settlement driver to the destination are excluded, with the reason.
curl -X POST "https://example.com/api/swap/quote/combined-depth"{ "assetIn": "string", "assetOut": "string", "dstChainId": 0, "requestedSize": "string", "legs": [ { "sourceId": "string", "venue": "aqua", "chainId": 0, "size": "string", "amountOut": "string", "avgPriceWad": "string", "bridgeRoute": [ "string" ], "local": true } ], "totalIn": "string", "totalOut": "string", "unfilled": "string", "bestSingle": { "sourceId": "string", "size": "string", "amountOut": "string" }, "improvementBps": 0, "excluded": [ { "sourceId": "string", "chainId": 0, "reason": "string" } ], "diagnostics": [ "string" ]}Preview a swap quote (1inch Aqua or Uniswap V4)
Simulates a swap and returns the preview WITHOUT any signature or capital hold. Both venues are just-in-time, meaning neither holds capital between swaps. The `venue` body field selects the path. `aqua` simulates against the 1inch Aqua router for a shipped-strategy fill (body: order, tokenIn, tokenOut, amountIn, takerData, with chainId as a query parameter). `v4` prices a just-in-time liquidity fill against Aqua0's own vault capital and JIT range preferences (body: poolId, chainId, token0, token1, swapDirection, tickSpacing, requestedAmount0/1, tradeType). Read-only.
Get the lifecycle status of a swap
Returns a focused view of one swap's lifecycle for cheap UI polling: the settlement breakdown plus its cross-chain repayment jobs. Status is COMPLETE (settled and every repayment delivered), SETTLED_DST (settled, repayments still in flight), or UNKNOWN (not yet seen on this server).