POST
PreviewQuote
Same pricing as GetQuote, minus the persistence. No quote hash is produced and nothing can be deposited against the result. Use it for the amount field of a swap form.

Request

string
required
Source chain name, lowercase.
string
required
Destination chain name, lowercase.
string
required
Source token address.
string
required
Destination token address.
TradeType
required
Which side of the trade amount fixes and whether the output is guaranteed: TRADE_TYPE_EXACT_INPUT, TRADE_TYPE_EXPECTED_OUTPUT, or TRADE_TYPE_EXACT_OUTPUT. TRADE_TYPE_UNSPECIFIED is rejected. See Trade types.
string
required
For exact input, the amount in the source token’s base units. For expected output, the desired output in the destination token’s base units.
string
required
Native asset to deliver on the destination, in base units. Empty string for none.
uint32
Slippage for the whole route, in basis points: min_amount_out is amount_out less this. On TRADE_TYPE_EXACT_INPUT, 0 asks for a guaranteed output.
uint32
Floor for the source swap leg, in basis points. Applies only when slippage_bps is omitted.
Referrer[]
Referrer addresses and their basis points, so the preview matches what the quote will charge.
There is no recipient or refund_address: nothing is bound.

Response

string
Input amount in the source token’s base units. Echoes the request for exact input; the solved input for expected output.
string
Expected output, net of every fee.
string
Floor implied by the applied slippage.
uint32
The requested slippage_bps, or, when it was omitted, the gap between amount_out and min_amount_out.
FeeBreakdown
Itemized costs, identical in shape to a quote’s.
bool
True when the pair resolves to a same-chain swap rather than a bridge.
bool
The output is committed: min_amount_out equals amount_out. See Guaranteed quotes.
string
Notional input value in USD micros. Optional.
string
Notional output value in USD micros. Optional.
uint64
Estimated seconds from deposit to fulfillment, the median over recent orders on the same chain pair and route type. Absent when there is no history and no configured default for the destination chain.

Notes

Preview and quote use the same pipeline, so the numbers agree at the same instant. They diverge only as the market moves between the two calls, which is why a confirmation screen should show a freshly fetched quote rather than the last preview. Errors are identical to GetQuote.

Headers

x-api-key
string

Optional. Without a key the request is rate limited per client IP and quotes carry extra spread.

Body

application/json
srcChain
string
dstChain
string
srcToken
string
dstToken
string
amount
string
slippageBps
integer<int32>
Required range: x >= 0
srcSlippageBps
integer<int32>
Required range: x >= 0
referrers
object[]
gasDrop
string
tradeType
enum<string>
Available options:
TRADE_TYPE_UNSPECIFIED,
TRADE_TYPE_EXACT_INPUT,
TRADE_TYPE_EXPECTED_OUTPUT,
TRADE_TYPE_EXACT_OUTPUT

Response

OK

amountIn
string
amountOut
string
minAmountOut
string
amountInUsdMicros
string
amountOutUsdMicros
string
slippageBps
integer<int32>
Required range: x >= 0
feeBreakdown
object
sameChainSwap
boolean
fulfillEtaSecs
string

64-bit unsigned integer, sent and returned as a decimal string

isGuaranteed
boolean