Routing Response

POST /routing/scan/stream streams route objects as NDJSON (newline-delimited JSON). Each line is a JSON object with either a simulation field (success) or an error field (failure). The simulation object contains the fields below.

POST /routing/scan returns all routes as a single JSON array. Each item has the same fields. Use /routing/scan/stream for better responsiveness — routes arrive as they are evaluated, rather than waiting for all providers to finish.

Field	Type	Description
query	object	Echo of request parameters (params, slippage)
route	array	Ordered list of route steps (pass entire object to /tx/create)
amountIn	string	Input amount in smallest token units
amountOut	string	Expected output amount in smallest token units
amountOutWithoutSlippage	string	Output amount without slippage applied
tokenInPrice	number	USD price of the input token
tokenOutPrice	number	USD price of the output token
priceImpact	number	Price impact as a percentage
sourceFee	object	Fee charged on the source chain
deliveryFee	object	Fee for cross-chain delivery
slippage	number	Slippage tolerance as provided in the request
expectedFinalitySeconds	number	Estimated time to finality in seconds
deadline	number	Expiration timestamp in milliseconds
signature	string	Encrypted signature (pass to /tx/create as-is)
txs	array	Per-chain gas estimates

Fee objects (sourceFee, deliveryFee)

Field	Type	Description
token	string	Token address the fee is denominated in
amount	string	Fee amount in smallest token units
usd	number	Fee value in USD

Gas estimate objects (txs array items)

Field	Type	Description
chainId	number	Chain where gas will be consumed
gasConsumption	number	Estimated gas units
gasFeeUsd	number	Gas cost in USD
gasFeeNative	string	Gas cost in the chain's native token

Route step objects (route array items)

Each step describes one leg of the swap:

Field	Type	Description
chainId	number	Chain where this step executes
type	string	Step type (e.g. "bridgeIn")
params.tokenIn	object	Input token (address, symbol, decimals)
params.tokenOut	object	Output token (address, symbol, decimals)
params.amountIn	string	Input amount for this step
params.amountOut	string	Output amount for this step

When calling /tx/create, pass the route object as the routing field. For /routing/scan/stream, this is the simulation object from each NDJSON line. For /routing/scan, this is an item from the response array. Do not modify or cherry-pick fields from it.

---