Skip to main content
GET
Get a quote for a token transfer
For preset options, use the preset query parameter. See the API presets overview. The stablecoin preset is ideal for stablecoin transfers and can be customized. To see supported stablecoins, use /v1/tokens?tags=stablecoin.
Use denyPools to exclude specific AMM pools or Solana venues from routing. Provide 1–100 identifiers and repeat the query parameter to exclude multiple entries:
  • Uniswap V2/V3: a non-zero EVM pool address (0x + 40 hex characters)
  • Uniswap V4: <poolManagerAddress>-<poolId>, where poolId is 0x + 64 hex characters
  • Solana: a venue’s program ID (base58), for example HumidiFi 9H6tua7jkLhdm3w8BvgpTn5LZNU7g4ZynDmCiNN3q6Rp. It excludes every pool of that venue. Individual Solana pool addresses are not supported.
Only some exchanges can exclude pools, so the entries restrict which exchanges a swap can use:
  • EVM pool entries restrict swaps on every chain except Solana to fly.
  • Solana program IDs restrict swaps on Solana to jupiter, titan and okx.
  • Swaps on a chain with no matching entries are not restricted.
Set slippageScope=route to make slippage the budget for the whole route instead of the tolerance for each step. toAmountMin is then a single floor, ceil(expected output × (1 − slippage)), which the returned transactionRequest enforces. The response carries a routeSlippage commitment.Supported for EVM routes with at most one swap. Routes that can’t be protected are refused with ROUTE_SLIPPAGE_UNSUPPORTED instead of falling back to per-step slippage. See Route-wide Slippage.

Headers

​
x-lifi-api-key
string

Authentication header, register in the LI.FI Partner Portal (https://portal.li.fi/ ) to get your API Key.

Query Parameters

​
fromChain
string
required

The sending chain. Can be the chain id or chain key

​
toChain
string
required

The receiving chain. Can be the chain id or chain key

​
fromToken
string
required

The token that should be transferred. Can be the address or the symbol

​
toToken
string
required

The token that should be transferred to. Can be the address or the symbol

​
fromAddress
string
required

The sending wallet address

​
toAddress
string

The receiving wallet address. If none is provided, the fromAddress will be used

​
fromAmount
string
required

The amount that should be sent including all decimals (e.g. 1000000 for 1 USDC (6 decimals))

​
order
enum<string>

Which kind of route should be preferred FASTEST: This sorting criterion prioritizes routes with the shortest estimated execution time. Users who value speed and want their transactions to be completed as quickly as possible should choose the fastest routes. CHEAPEST: This criterion focuses on minimizing the cost of the transaction, whether in token amount or USD amount (USD amount minus gas cost). Users looking for the most economical option should choose the cheapest routes.

Available options:
FASTEST,
CHEAPEST
​
slippage
number

The maximum allowed slippage for the transaction as a decimal value. 0.005 represents 0.5%.

Required range: 0 <= x <= 1
​
slippageScope
enum<string>

Scope of slippage. step (default, same as omitted): slippage applies to every step and toAmountMin combines the steps' minimums. route: slippage is the budget for the whole route, toAmountMin is one floor, ceil(expected output × (1 − slippage)), that the returned transaction enforces, and the response carries a routeSlippage commitment. Supported for EVM routes with at most one swap: a swap on one chain, or a bridge that delivers to the recipient with or without one swap before it. Other routes are refused with ROUTE_SLIPPAGE_UNSUPPORTED instead of falling back to step scope. When slippage is omitted, the budget is the default slippage. See Route-wide Slippage.

Available options:
step,
route
​
integrator
string

A string containing tracking information about the integrator of the API

​
fee
number

The percent of the integrator's fee that is taken from every transaction. 0.02 represents 2%. The maximum fee amount should be less than 100%.

Required range: 0 <= x < 1
​
distributionFees
Root Type for DistributionFeeEntry · object[]

Optional array of partner-specified fee distributions. Each entry transfers its percentage of the source fromAmount to the receiver address in parallel with the integrator fee and any intermediary carve-out. On GET quote endpoints, encode entries with indexed query keys (distributionFees[0][receiver], distributionFees[0][percentage]); a JSON string in a single query parameter is rejected with a validation error. OpenAPI 3.0 does not define serialization for nested arrays of objects, so generated clients and API consoles must construct these indexed keys explicitly instead of using the default query serialization. On EVM and Tron this requires FeeForwarder on the source chain (legacy FeeCollector chains are rejected); on Solana each receiver is paid with its own transfer instruction and at most 2 entries are accepted. The receiver form must match the source chain: 0x-prefixed hex on EVM/Tron, base58 on Solana. Limits: 1..10 entries, each percentage in (0, 0.5); total of all distribution percentages plus the integrator fee must be strictly less than 1. Receivers are sanctions-screened at transaction-build time. On Solana swap-and-bridge routes the percentages apply to the swap output in the intermediate token.

Required array length: 1 - 10 elements
​
referrer
string

A string containing tracking information about the referrer of the integrator

​
allowBridges
string[]

List of bridges that are allowed for this transaction. Retrieve the current catalog from the /v1/tools endpoint. Also values all, none, default and [] are acceptable and mean all tools of the current type (all), no tools (for none and [] cases) and default tool's settings on the current stage.

Bridge tool identifier or keyword. Retrieve current bridge keys from the /v1/tools endpoint. Supported keywords: all, none, default, [].

​
allowExchanges
string[]

List of exchanges that are allowed for this transaction. Retrieve the current catalog from the /v1/tools endpoint. Also values all, none, default and [] are acceptable and mean all tools of the current type (all), no tools (for none and [] cases) and default tool's settings on the current stage.

Exchange tool identifier or keyword. Retrieve current exchange keys from the /v1/tools endpoint. Supported keywords: all, none, default, [].

​
denyBridges
string[]

List of bridges that are not allowed for this transaction. Retrieve the current catalog from the /v1/tools endpoint. Also values all, none, default and [] are acceptable and mean all tools of the current type (all), no tools (for none and [] cases) and default tool's settings on the current stage.

Bridge tool identifier or keyword. Retrieve current bridge keys from the /v1/tools endpoint. Supported keywords: all, none, default, [].

​
denyExchanges
string[]

List of exchanges that are not allowed for this transaction. Retrieve the current catalog from the /v1/tools endpoint. Also values all, none, default and [] are acceptable and mean all tools of the current type (all), no tools (for none and [] cases) and default tool's settings on the current stage.

Exchange tool identifier or keyword. Retrieve current exchange keys from the /v1/tools endpoint. Supported keywords: all, none, default, [].

​
denyPools
string[]

One to 100 AMM pool or Solana venue identifiers to exclude from routing. Repeat the query parameter for multiple entries. Each entry is a non-zero Uniswap V2/V3 pool address (0x + 40 hex), a Uniswap V4 composite <poolManagerAddress>-<poolId> where poolId is a 32-byte hex string (0x + 64 hex), or a Solana venue program ID (base58), which excludes every pool of that venue. Identifiers of other chains are rejected; individual Solana pool addresses are not supported. Only some exchanges can exclude pools: EVM pool entries restrict swaps on every chain except Solana to the fly exchange, and Solana program IDs restrict swaps on Solana to jupiter, titan and okx. Swaps on a chain with no matching entries are not restricted.

Required array length: 1 - 100 elements
​
preferBridges
string[]

List of bridges that should be preferred for this transaction. Retrieve the current catalog from the /v1/tools endpoint. Also values all, none, default and [] are acceptable and mean all tools of the current type (all), no tools (for none and [] cases) and default tool's settings on the current stage.

Bridge tool identifier or keyword. Retrieve current bridge keys from the /v1/tools endpoint. Supported keywords: all, none, default, [].

​
preferExchanges
string[]

List of exchanges that should be preferred for this transaction. Retrieve the current catalog from the /v1/tools endpoint. Also values all, none, default and [] are acceptable and mean all tools of the current type (all), no tools (for none and [] cases) and default tool's settings on the current stage.

Exchange tool identifier or keyword. Retrieve current exchange keys from the /v1/tools endpoint. Supported keywords: all, none, default, [].

​
allowDestinationCall
boolean

Whether swaps or other contract calls should be allowed as part of the destination transaction of a bridge transfer. Separate swap transactions on the destination chain are not affected by this flag. By default, parameter is true.

​
fromAmountForGas
string

The amount of the token to convert to gas on the destination side.

​
maxPriceImpact
number

The price impact threshold above which routes are hidden. As an example, one should specify 0.15 (15%) to hide routes with more than 15% price impact. The default is 10%.

​
swapStepTimingStrategies
string[]

Timing setting to wait for a certain amount of swap rates. In the format minWaitTime-${minWaitTimeMs}-${startingExpectedResults}-${reduceEveryMs}. Please check docs.li.fi for more details.

​
routeTimingStrategies
string[]

Timing setting to wait for a certain amount of routes to be generated before chosing the best one. In the format minWaitTime-${minWaitTimeMs}-${startingExpectedResults}-${reduceEveryMs}. Please check docs.li.fi for more details.

​
skipSimulation
boolean

Parameter to skip transaction simulation. The quote will be returned faster but the transaction gas limit won't be accurate.

​
preset
string

Pre-configured routing optimization preset. The preset value stablecoin is supported for requesting swap and/or bridging operations involving stablecoin tokens. Each preset provides optimized default settings for slippage, price impact, and tool preferences that can be overridden by custom configuration parameters set in the request.

Required string length: 1 - 50
Pattern: ^[a-zA-Z0-9-_]+$
​
svmMaxSupportedTransactionVersion
enum<number> | null
default:0

Maximum Solana transaction version the client can sign. Defaults to 0; omission or null uses v0. Set to 1 to allow V1 where enabled for the environment. Jito requests always use v0. Size overflow may fall back to v0. Read transactionRequest.svmTransactionVersion for the version actually built. Ignored for source chains other than Solana.

Available options:
0,
1
​
svmPriorityFeeLevel
enum<string>

Priority fee level for Solana Virtual Machine (SVM) transactions.

Available options:
NORMAL,
FAST,
ULTRA

Response

The step populated with the transaction data

Object that represents one step of a Route

​
id
string
required

Unique identifier of the step

​
type
enum<string>
required

The type of the step. swap executes a DEX swap on a single chain, cross bridges assets between chains, lifi runs LiFi's internal multi-action logic, and protocol represents protocol-level actions such as fee collection or vault interactions executed inside LiFi managed contracts.

Available options:
swap,
cross,
lifi,
protocol
​
tool
string
required

The tool used for this step. E.g. relay

​
action
Root Type for Action · object
required

The action of the step

Example:
​
toolDetails
object

The details of the tool used for this step. E.g. relay

​
estimate
Root Type for Estimate · object

The estimation for the step

Example:
​
routeSlippage
Root Type for RouteSlippageCommitment · object

Present only when the route was requested with slippageScope=route. The route-wide slippage commitment: post it back unchanged with the step to /v1/advanced/stepTransaction.

Example:
​
integrator
string

A string containing tracking information about the integrator of the API

​
includedSteps
Root Type for Internal Step · object[]
​
referrer
string

A string containing tracking information about the referrer of the integrator

​
execution
any

An objection containing status information about the execution

​
transactionRequest
object

An ether.js TransactionRequest that can be triggered using a wallet provider. (https://docs.ethers.io/v5/api/providers/types/#providers-TransactionRequest) Solana responses also include svmTransactionVersion (0 or 1), the version actually built. This may be lower than the requested maximum.