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

Request

  • Base URL
    https://api.enso.build
  • URL
    https://api.enso.build/api/v1/simulate
  • Auth
    none required

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
stateOverrideunknown
status'Success' | 'Error' required

Example response

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

Changes

No recorded changes to this operation across all 1 revision of this API.