v1

latestOpenAPI 3.0.0ISC2026-07-26318688.6 KB
Quotes

Get available quotes for a given amount and token pair.

get/quotes

Query parameters

amountnumber double required

Amount of the from token to swap as a decimal float in the token's display units (e.g. 1.5 BTC, 250.75 USDT) — not a base-units / wei integer like 100000000000000. Must be strictly greater than 0 and at most the maximum BSON Double value (Number.MAX_VALUE ≈ 1.7976931348623157e308).

fromstring required

Token ID from which the swap is initiated. Must be a MongoDB ObjectId (24-char hex string), not a symbol. Use GET /v2/tokens to look up token IDs.

tostring required

Token ID to which the swap is directed. Must be a MongoDB ObjectId (24-char hex string), not a symbol. Use GET /v2/tokens to look up token IDs.

slippagenumber double

Slippage percentage, only used for decentralized swaps.

useXmrboolean

Use XMR if true, if false use another token for the anonymous transaction

fixedboolean

Request a fixed-rate quote. Only partners that support fixed rate will be returned.

refundAddressstring

Sender's wallet address for refunds if a fixed-rate swap fails.

deviationThresholdnumber double

Maximum price deviation percentage when rotating wallets. Only used if rotatePayoutWallets is true. Default 5

rotationLookbackinteger

Number of recent orders to check for path rotation. Only used if rotatePayoutWallets is true. Default 10

rotatePayoutWalletsboolean

Enable payout wallet rotation for better privacy. Only used for centralized quotes

rotateFallbackboolean

When strict rotation exhausts every rotated route, fall back to a valid non-rotated route instead of failing. Default false. Requires rotatePayoutWallets — a no-op on its own.

typesQuoteType[]

Types of quotes to return; if omitted, all types are used

swapsExchangeType[]

Swaps to use for the quote; if omitted, all swaps are used

inLegIncludedSwapsstring[]

Allowlist for the in-leg of anonymous (private, 2-hop) paths. When set, only these providers may be used as the in-leg. Silently ignored for STANDARD and DEX quotes, which are single-hop and have no in/out leg concept.

inLegExcludedSwapsstring[]

Providers excluded from the in-leg of anonymous (private, 2-hop) paths. Does not affect the out-leg. Silently ignored for STANDARD and DEX quotes, which are single-hop and have no in/out leg concept.

outLegIncludedSwapsstring[]

Allowlist for the out-leg of anonymous (private, 2-hop) paths. When set, only these providers may be used as the out-leg. Silently ignored for STANDARD and DEX quotes, which are single-hop and have no in/out leg concept.

outLegExcludedSwapsstring[]

Providers excluded from the out-leg of anonymous (private, 2-hop) paths. Does not affect the in-leg. Silently ignored for STANDARD and DEX quotes, which are single-hop and have no in/out leg concept.

senderAddressstring

Address of the wallet initiating the swap

receiverAddressstring

If different from senderAddress, DEX routes that don't support sending to another wallet are filtered. Also used for payout wallet rotation

sort'amountOut' | 'amountOutUsd' | 'amountIn' | 'duration'

Sort the quotes by the given field (default: amountOut)

sortOrder'asc' | 'desc'

Sort direction for quotes (default: desc)

amountType'send' | 'receive'

Whether amount refers to the send side or the receive side.

  • "send" (default): amount is what the user sends — system computes what they receive.
  • "receive": amount is what the user wants to receive — system computes what they must send. Only supported for standard CEX quotes.

Response

Success

totalnumber double required