Returns the best available routes for one or more swap/bridge pairs, including recommended provider, priced route, and fees. Transaction calldata is not included - call /v1/buildTx separately once you’ve picked a route.
Body
integer
required
Source chain ID for every item in data.
object[]
required
Array of trade requests to quote.
Show data item
string
required
Amount to send, in the source token’s smallest unit.
string
required
Source token contract address.
integer
Source token decimals (skips a lookup if provided).
string
required
Destination token contract address.
integer
Destination token decimals (skips a lookup if provided).
integer
required
Destination chain ID.
number
required
Slippage tolerance, in percent.
string
Restrict/prefer quoting to a specific provider ID.
string
User’s wallet address.
string
Quote filter: all (default), best, or fastest.
boolean
Request gasless-eligible quotes.
boolean
Request private/MEV-protected quotes.
boolean
Skip gas/output estimation for a faster response.
object
Allow/deny list of bridge providers: { allow?: string[]; deny?: string[] }.
object
Allow/deny list of DEX providers: { allow?: string[]; deny?: string[] }.
object
Fine-tune quote collection timing.
Show timingStrategy
integer
Minimum wait time before returning results. Default 1000.
integer
Maximum wait time for quote optimization. Default 5000.
integer
Delay between subsequent provider batches. Default 500.
integer
Target number of quotes to collect. Default 3.
boolean
Return partial results once maxWaitTimeMs is hit.
Response
The response is an object keyed by pair identifier ({fromChain}_{srcToken}_{toChain}_{destToken}), not wrapped in a data envelope.
string
Per-pair status, if applicable.
string
Provider ID of the recommended route.
string
Provider ID with the best return - use as a fallback route.
string
Provider ID with the fastest execution (bridge quotes only).
object
Map keyed by provider ID, each value a full quote.
Show quote
object
Show providerDetails
string
string
string
object
Present for bridge routes. Same shape as providerDetails above.
string
string
string
string
string
string
Effective exchange rate for this route.
object
Show srcToken
string
integer
integer
string
string
string
object
Same shape as srcToken above.
string
string
Estimated seconds to completion.
boolean
object
Show fee
object[]
Show fee item
string
integer
integer
string
string
string
boolean
Whether the fee is already netted into the shown amounts.
object[]
Same item shape as gasFee above.
object[]
Same item shape as gasFee above.
object[]
High-level step summary.
Show step item
string
object
{ logo, name }.
object[]
Detailed route path.
Show path item
string
object
Same shape as providerDetails above.
object
Same shape as the top-level srcToken above.
string
string
object
Same shape as the top-level srcToken above.
string
string
object
Same shape as the top-level fee above.
object[]
Optional route badges.
Show tag item
string
string
string
object
Provider-specific extra data (shape varies).
object
Map of chainId → token addresses missing price data.