v1

latestOpenAPI 3.0.02026-07-26278284.4 KB

quote

Simulate already-built transactions (standalone)

Standalone simulator that returns predicted output amounts and gas for transactions that are ALREADY built (from any source). This is NOT part of the routing flow and is NOT a prerequisite for /shortcuts/route — route already quotes internally and returns executable calldata in a single call. Do not call this before routing. Use it only to independently simulate/validate arbitrary transactions you already have.

post/api/v1/simulate

Headers

x-request-idstring required

Request body

amountInDecimalU256[] required

List of input amounts (as decimal strings)

chainIdinteger required

Chain ID (e.g., 1 for Ethereum mainnet)

tokenInstring[] required

List of input token addresses

tokenOutstring[] required

List of output token addresses

Example request

{
  "amountIn": [
    "1000000000000000000"
  ],
  "chainId": 1,
  "transactions": [
    {
      "data": "0x1234",
      "from": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
      "to": "0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D",
      "value": "1000000000000000000"
    }
  ]
}

Response

Quote successful

amountOutDecimalU256[]

Output amounts for each output token (as decimal strings)

gasstring

{"stackTrail":"components:schemas:QuoteResponse:properties:stateOverride","oasType":"schema","type":"unknown","description":"State override used for simulation"}

status'Success' | 'Error' required

Example response

[
  {
    "amountOut": [
      "1000000000000000000"
    ],
    "gas": "1000000000000000000"
  }
]