Skip to main content
Shops every eligible venue and returns the best price plus an opaque quoteToken to pass to /execute.

​
Request

​
integer
required
Origin chain ID.
​
integer
required
Destination chain ID.
​
string
required
Contract address or mint, or the native sentinel.
​
string
required
Contract address or mint, or the native sentinel.
​
string
required
Positive integer in the token’s smallest unit.
​
string
required
The sender’s address.
​
string
Recipient on the destination chain. Some venues need this here, at quote time, to return a firm, executable quote at all: notably Relay when Bitcoin is the source, THORChain on a Bitcoin route either direction, Across on a Solana-touching route, and Eco on a cross-ecosystem route. Omit it on those and you get back a priced but unexecutable preview instead (see executable below), not an error. Most other venues also accept it as a late addition on /execute, but Relay, Across, Eco, and THORChain commit the recipient at quote time regardless and ignore a different value supplied later rather than erroring, so supply the real address here whenever you have it.
​
string
Where the input asset is refunded if the swap fails. A Bitcoin-source Relay or THORChain quote both require this here, at quote time, for the same reason as destinationAddress above. Garden and Chainflip accept it as a late addition on /execute instead.
​
integer
1 to 5000. Omit for the venue default.
​
string
best_output (default) or fastest. best_output is the literal highest net output, full stop. fastest picks the quickest-settling quote among quotes within slippageBps, even at a real output cost.
No API key required (see Authentication for the optional higher-limit tiers).

​
Response

​
string
Opaque handle. Pass it to /execute verbatim and do not parse it. It expires.
​
object
The id and name of the winning venue.
​
string
For example, CROSS_ECOSYSTEM or EVM_CROSS_CHAIN.
​
object
The input token and amount.
​
object
The output token and expected amount.
​
object
The applied integrator fee, with bps, amount, and token.
​
boolean
False means this is a preview only, priced against a placeholder destination or refund address rather than the ones you supplied (or didn’t). Posting quoteToken to /execute in that state fails with 400 QUOTE_NOT_EXECUTABLE. Request a fresh quote with the missing address instead of retrying /execute.
​
object
The bps, isFirm, and guaranteedMin, or null.
​
object
Native gas the user must hold: native, nativeSymbol, usd, and estimated. Null on gasless venues.
​
integer
​
boolean
True when the venue didn’t report a timing figure for this quote, so estimatedTimeSeconds is a generic placeholder rather than a venue-reported number.
​
integer
Epoch milliseconds when the quote expires.
Returns 404 NO_LIQUIDITY when no venue can serve the pair or amount.