跳转到主要内容
GET
Get a quote for a token transfer
如需使用预设选项，请使用 preset 查询参数。参见 API 预设概览。stablecoin 预设 非常适合 stablecoin 转账，并且可以自定义。要查看支持的 stablecoin，请使用 /v1/tokens?tags=stablecoin。
使用 denyPools 可将特定 AMM 资金池或 Solana 交易场所排除在路由之外。请提供 1–100 个标识符；如需排除多个条目，请重复传入该查询参数：
  • **Uniswap V2/V3：**非零 EVM 资金池地址（0x + 40 位十六进制字符）
  • Uniswap V4：<poolManagerAddress>-<poolId>，其中 poolId 为 0x + 64 位十六进制字符
  • **Solana：**交易场所的程序 ID（base58），例如 HumidiFi 9H6tua7jkLhdm3w8BvgpTn5LZNU7g4ZynDmCiNN3q6Rp。它会排除该交易场所的所有资金池。不支持单个 Solana 资金池地址。
只有部分交易所支持排除资金池，因此这些条目会限制 swap 可使用的交易所：
  • EVM 资金池条目会将除 Solana 以外所有链上的 swap 限制为使用 fly。
  • Solana 程序 ID 会将 Solana 上的 swap 限制为使用 jupiter、titan 和 okx。
  • 如果某条链上没有匹配的条目，该链上的 swap 不受限制。
设置 slippageScope=route，可让 slippage 成为整条路由的预算，而不是每个步骤的容忍度。此时 toAmountMin 是单一下限，即 ceil(预期输出 × (1 − slippage))，返回的 transactionRequest 会强制执行该下限。响应会携带 routeSlippage 承诺。支持最多包含一次 swap 的 EVM 路由。无法受到保护的路由会被拒绝并返回 ROUTE_SLIPPAGE_UNSUPPORTED，而不会回退为按步骤滑点。参见整条路由滑点。

请求头

x-lifi-api-key
string

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

查询参数

fromChain
string
必填

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

toChain
string
必填

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

fromToken
string
必填

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

toToken
string
必填

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

fromAddress
string
必填

The sending wallet address

toAddress
string

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

fromAmount
string
必填

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.

可用选项:
FASTEST,
CHEAPEST
slippage
number

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

必填范围: 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.

可用选项:
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%.

必填范围: 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

Skips the EVM step simulation of the generated transaction. Honoured only for integrators configured by LI.FI; for every other caller it is accepted for backward compatibility and ignored (the transaction is simulated as usual). When honoured, the gas limit comes from the tool estimate, a transaction that would revert is not rejected, and the step carries stepSimulation.status: not-attempted with disabledReason: skip_requested.

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
默认值: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.

可用选项:
0,
1
svmPriorityFeeLevel
enum<string>

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

可用选项:
NORMAL,
FAST,
ULTRA

响应

The step populated with the transaction data

Object that represents one step of a Route

id
string
必填

Unique identifier of the step

type
enum<string>
必填

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.

可用选项:
swap,
cross,
lifi,
protocol
tool
string
必填

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

action
Root Type for Action · object
必填

The action of the step

示例:
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

示例:
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.

示例:
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.

stepSimulation
Step simulation metadata · object

Metadata about step-level transaction simulation during stepTransaction. Present on EVM and Solana stepTransaction responses when the simulation runs (on EVM, when gas limits are resolved).