v1

latestOpenAPI 3.0.0ISC2026-07-26318688.6 KB
Quotes

Get Quotes By Chain And Address

Get CEX/DEX quotes using token chain/address pairs.

Resolves both tokens via dex.getToken and runs the same quote flow as v2 quote endpoint.

get/quotes/byChainAddress

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).

fromChainstring required

Source chain identifier — shortName from GET /v2/chains (e.g. "ethereum", "kava_2222-10", "AssetHub") or numeric EVM chainId (e.g. "1", "42161").

toChainstring required

Destination chain identifier — shortName from GET /v2/chains (e.g. "ethereum", "kava_2222-10", "AssetHub") or numeric EVM chainId (e.g. "1", "42161").

fromTokenAddressstring
toTokenAddressstring
slippagenumber double

Slippage percentage, only used for decentralized swaps.

useXmrboolean
fixedboolean

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

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
rotateFallbackboolean
typesQuoteType[]
swapsExchangeType[]
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
receiverAddressstring
sort'amountOut' | 'amountOutUsd' | 'amountIn' | 'duration'
sortOrder'asc' | 'desc'

Response

Success

totalnumber double required