Get ranked routes for a swap, without building anything

tokenIn/tokenOut accept a contract address or a symbol (case-insensitive). A symbol matching more than one token on that chain returns 409 ambiguous_token with every candidate — never guesses. Pass wallet to persist a buildable handoff; without wallet the quotes are indicative and can only be shown. A machine credential is optional and affects rate limiting, not whether a quote is executable.

post/quote

Request

  • Base URL: https://swap.vurto.cc/v1
  • URL: https://swap.vurto.cc/v1/quote
  • Auth: none required

Request body

walletstring

Optional EVM signing address. Makes quotes[].id buildable through POST /swap.

chainIdinteger required
tokenInstring required

Address or symbol.

tokenOutstring required

Address or symbol.

amountstring

Human decimal amount, e.g. "1.5". Use this OR amountRaw, not both.

amountRawstring

Raw integer string in the input token's smallest unit.

slippageBpsinteger

Defaults to a sane per-pair value server-side when omitted.

receiverstring

Optional address to deliver the output to, if different from the signing wallet. Only providers with supportsReceiver: true are returned when this is set — see NormalizedQuote. Building with it requires the paying wallet's signed authorization (POST /destination/challenge, then /destination/authorize) or an invoiceId whose recipient is this address; otherwise the build fails with 403 destination_not_authorized.

invoiceIdstring

Optional: the open invoice this swap pays (INV-XXXX-XXXX). Its recipient, on the same chain, is accepted as receiver without a destination signature.

Response

OK

requestIdstring uuid
bestQuoteIdstring nullable
indicativeboolean
refreshedAtinteger

Changes

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