API 参数

当 toToken 被设置为受支持协议的代币地址时，Composer 会自动激活。除标准的 LI.FI 报价参数外，无需任何额外参数。

`toToken` 如何触发 Composer

当 toToken 对应一个受支持的 vault/质押/存入代币时，LI.FI 的路由引擎会自动：

将其识别为一条 Composer 路由
找到获取底层资产的最优路径（交换、桥接，或两者兼有）
编译 Composer 指令（eDSL → 字节码）
模拟完整的执行路径
返回一个可直接签署的 transactionRequest

与 Composer 相关的参数

这些参数是标准 GET /quote 和 POST /advanced/routes 端点的一部分。它们并非 Composer 特有，但在构建 Composer 集成时尤为相关。

参数	类型	必填	说明
`fromChain`	number	是	源链 ID（例如 `1` 表示 Ethereum，`8453` 表示 Base）
`toChain`	number	是	目标链 ID。同链存入时与 `fromChain` 相同。
`fromToken`	string	是	源代币地址。原生代币使用 `0x0000000000000000000000000000000000000000`。
`toToken`	string	是	vault/质押/存入代币地址。这就是触发 Composer 的因素。
`fromAmount`	string	是	以 `fromToken` 的最小单位表示的金额（例如 `1000000` 表示 6 位小数的 1 USDC）。
`fromAddress`	string	是	发送方的钱包地址。
`toAddress`	string	是	接收方的钱包地址。通常与 `fromAddress` 相同。在代人存入 flow 中可以不同。
`slippage`	number	否	以小数表示的最大可接受价格差异。`0.005` = 0.5%。默认为 `0.005`。
`integrator`	string	否	在分析数据和链上事件中标识你的应用。最多 23 个字符。
`allowBridges`	string[]	否	将路由限制为特定的桥（例如 `["stargate","across"]`）。可通过 `GET /v1/tools` 获取。
`denyBridges`	string[]	否	在路由中排除特定的桥。
`allowExchanges`	string[]	否	将路由限制为特定的 DEX 聚合器。可通过 `GET /v1/tools` 获取。
`denyExchanges`	string[]	否	在路由中排除特定的 DEX 聚合器。
`order`	string	否	路由偏好：`"FASTEST"` 或 `"CHEAPEST"`。

识别 Composer 路由

Composer 工具名称

Composer 的工具标识符为 "composer"。此字符串出现在：

quote.tool：用于该路由的顶层工具
quote.toolDetails.key：相同的值，另附 name 和 logoURI
quote.includedSteps[].tool：路由中每个步骤所使用的工具

当 toToken 匹配一个受支持的协议代币时，Composer 会自动激活。你无法在请求层面对 Composer 路由进行筛选（无论是包含还是排除）。它由 toToken 地址决定。

在你的应用中检测 Composer 路由

使用响应中的 tool 字段来构建条件式 UI：

const { data: quote } = await axios.get("https://li.quest/v1/quote", {
  params,
});

if (quote.tool === "composer") {
  // Composer route: show deposit/staking UI
  showComposerUI(quote);
} else {
  // Standard swap or bridge: show swap UI
  showSwapUI(quote);
}

控制桥和交易所

你可以使用标准的桥/交易所过滤参数，来控制在一条 Composer 路由内使用哪些桥或 DEX 聚合器：

const { data: quote } = await axios.get("https://li.quest/v1/quote", {
  params: {
    ...params,
    allowBridges: ["stargate", "across"], // Only use these bridges for cross-chain
    order: "FASTEST", // Prefer speed over cost
  },
});

完整参数参考

有关完整的端点文档、参数列表和身份验证详情，请参阅：

GET /quote

包含所有参数的单步报价端点

POST /advanced/routes

包含所有参数的多路由端点

Quote vs Route

何时使用各个端点

API Overview

基础 URL、身份验证和速率限制

API Integration Guide

包含响应 schema 的分步 Composer 集成

Withdrawals Guide

使用相同的 API 接口实现提款路由

Error Handling

处理 Composer 特有的错误

Supported Protocols

完整的受支持 vault/质押代币列表及示例地址

简介

通过 Composer API 集成

通过 LI.FI API 集成

资源

`toToken` 如何触发 Composer

与 Composer 相关的参数

识别 Composer 路由

Composer 工具名称

在你的应用中检测 Composer 路由

控制桥和交易所

完整参数参考

GET /quote

POST /advanced/routes

Quote vs Route

API Overview

相关页面

API Integration Guide

Withdrawals Guide

Error Handling

Supported Protocols

​toToken 如何触发 Composer

​与 Composer 相关的参数

​识别 Composer 路由

​Composer 工具名称

​在你的应用中检测 Composer 路由

​控制桥和交易所

​完整参数参考

GET /quote

POST /advanced/routes

Quote vs Route

API Overview

​相关页面

API Integration Guide

Withdrawals Guide

Error Handling

Supported Protocols

`toToken` 如何触发 Composer

与 Composer 相关的参数

识别 Composer 路由

Composer 工具名称

在你的应用中检测 Composer 路由

控制桥和交易所

完整参数参考

相关页面