search

quote

API reference to fetch a quote for a swap.

circle-info

Enzyme

To execute swap with your Enzyme vault note the following:

  • taker: Address of your Enzyme vault

  • txOrigin: Address of the authorized "Manager" or "Asset Manager"

  • encodingType: Set to "enzyme-vault"

hashtag
Get quote for a swap

get
Query parameters
sellTokenstringRequired

Address of the sell token

Example: 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48
buyTokenstringRequired

Address of the buy token

Example: 0x2260fac5e5542a773aa44fbcfedf7c193bc2c599
sellAmountstringRequired

Sell amount in token base units (e.g. Wei for ETH)

Example: 1000000000000
takerstringRequired

Address which holds the sellToken. (Allowance has to be set before execution)

Example: 0xab5801a7d398351b8be11c439e05c5b3259aec9b
txOriginstringOptional

Address of the external account that executed the tx. (Only needed if taker is a contract)

Example: 0xab5801a7d398351b8be11c439e05c5b3259aec9b
typesarrayOptional

(WIP) Liquidity sources types

sourcesanyOptional

Configuration allows three strategies: empty, include or exclude.

  • Empty: all sources are enabled.
  • Include (Whitelisting): only the given sources are enabled.
  • Exclude (Blacklisting): all sources except the given ones are enabled.
maxSlippageBpsnumber · max: 10000Optional

Maximum allowed slippage for the swap. (in basis points)

Default: 50
maxPriceImpactBpsnumber · max: 10000Optional

Max price impact for the swap. (in basis points)

Default: 10000
priceImpactExceedsErrorbooleanOptional

If true an error is returned if the price impact is exceeded. Otherwise an issue (warning) is added to the response. Defaults to false.

Default: false
minExpirySecnumber · min: 10 · max: 120Optional

Min quote expiry. (in seconds) RFQ/OTC quotes from market makers have hard expiries between 40-90 seconds. If minExpiry is set higher then MM expiries these MMs are excluded. (Keep in mind that MM pricing might be better than DEX pricing, especially if quantity is high)

Default: 35
skipSimulationbooleanOptional

Skip Tenderly simulation

Default: false
skipChecksbooleanOptional

Skip balance and allowance checks

Default: false
encodingTypestring · enumOptional

Encoding type for the returned raw transaction.

Default: basicPossible values:
Header parameters
x-api-keystringOptional

31Third API key (Request via [email protected])

chain-idstringOptional

Chain ID as hex string. (e.g.: 0x1 for Ethereum mainnet)

Responses
chevron-right
200Success
application/json
idstringRequired

Unique ID of the calculated swap price.

Example: 0096124c-19df-4459-8cbb-7615fdc7c157
sellAmountinteger · int64Required

Amount to sell. (In sell token units)

Example: 100000000
buyAmountinteger · int64Required

Estimated buy amount. (In buy token units)

Example: 99500000
pricenumberRequired

Price of the buy token in sell token. E.g. 1 BTC = 100.000 USD; you sell WBTC and buy USDC; the price is 0.000001

Example: 0.999955
priceImpactBpsnumber · min: -10000 · max: 10000Required

Estimated price impact in basis points. [-10_000;10_000]. > 0 = value loss. < 0 = value gain

Example: 31
minBuyAmountinteger · int64Required

Minimal buy amount. (In buy token units)

Example: 99500000
guaranteedPricenumberRequired

Guaranteed price of the buy token in sell token.

Example: 0.999955
maxPriceImpactBpsnumber · min: -10000 · max: 10000Required

Maximum price impact in basis points. [-10_000;10_000]. > 0 = value loss. < 0 = value gain

Example: 42
expiresAtstring · date-timeRequired

If the swap contains RFQ/OTC fills this is a hard deadline. If not this can be considered as soft deadline. (Can be null if all fills are DEX based.) A new swap should be calculated every 20 - 30 seconds since market prices might change quickly.

Example: 2025-10-17T08:27:04.622Z
get
/1.3/swap/quote
200Success
PreviouspriceNextBasket Trade (m:n swap)

Last updated