提款 - LI.FI

提款遵循与存入相同的集成模式。使用 GET /quote 或 POST /advanced/routes，将用户的头寸代币作为 fromToken，将期望的输出代币作为 toToken。

提款适用于支持 Withdraw 操作的协议。请查看支持的协议参考文档以了解各协议的能力。

提款的工作原理

参数	在提款中的作用
`fromToken`	用户持有的协议头寸代币（vault 代币、aToken、LST 等）
`toToken`	用户希望收到的代币
`fromChain` / `toChain`	本地提款时为同一条链；跨链提款时为不同的链

如果协议和市场支持通过 Composer 提款，LI.FI 将返回一个支持 Composer 的路由。

同链提款

在同一条链上从协议头寸提款到底层代币。

curl -X GET 'https://li.quest/v1/quote?\
fromChain=CHAIN_ID&\
toChain=CHAIN_ID&\
fromToken=PROTOCOL_POSITION_TOKEN_ADDRESS&\
toToken=DESIRED_OUTPUT_TOKEN_ADDRESS&\
fromAddress=0xYOUR_WALLET_ADDRESS&\
toAddress=0xYOUR_WALLET_ADDRESS&\
fromAmount=POSITION_AMOUNT_IN_SMALLEST_UNIT'

const quote = await axios.get("https://li.quest/v1/quote", {
  params: {
    fromChain: CHAIN_ID,
    toChain: CHAIN_ID,
    fromToken: "PROTOCOL_POSITION_TOKEN_ADDRESS",
    toToken: "DESIRED_OUTPUT_TOKEN_ADDRESS",
    fromAddress: "0xYOUR_WALLET_ADDRESS",
    toAddress: "0xYOUR_WALLET_ADDRESS",
    fromAmount: "POSITION_AMOUNT_IN_SMALLEST_UNIT",
  },
});

跨链提款

在一条链上提款，并在单个 flow 中于另一条链上收到输出代币。

fromChain=SOURCE_CHAIN_ID&\ toChain=DESTINATION_CHAIN_ID&\
fromToken=PROTOCOL_POSITION_TOKEN_ADDRESS&\
toToken=DESTINATION_OUTPUT_TOKEN_ADDRESS&\ fromAddress=0xYOUR_WALLET_ADDRESS&\
toAddress=0xYOUR_WALLET_ADDRESS&\ fromAmount=POSITION_AMOUNT_IN_SMALLEST_UNIT'

跨链提款需要在源链交易确认后通过 GET /status 进行状态轮询。请参阅跨链 Composer 模式。

执行 flow

执行步骤与 Composer 存入完全相同。

通过 /quote 或 /advanced/routes 请求报价
如果存在 approvalAddress 且 fromToken 为 ERC-20，则设置代币授权额度
提交 transactionRequest
对跨链转账轮询 /status

API Integration

报价、授权额度、执行和状态轮询 flow 的完整演练。

支持 Withdraw 的协议

以下协议支持通过 Composer 提款。仅支持存入的协议（Ethena、Kinetiq、Maple、Royco）必须通过它们自己的界面提款。

协议	类型	通过 Composer 提款
Aave V3	Lending	是
Avant	Yield	是
Avon	Lending	是
Cap	Yield	是
Euler	Lending	是
Felix Vanilla	Vaults	是
Fluid	Lending	是
HyperLend	Lending	是
HypurrFi	Lending	是
Kelp	Liquid Staking	是
Morpho V1/V2	Lending / Vaults	是
Neutrl	Yield	是
Neverland	Vaults	是
Spark	Lending	是
Tokemak	Yield	是

Supported Protocols

完整的协议参考，包括仅支持存入与支持存入 + 提款的对比。

错误处理

提款特有的常见问题：

问题	解决方法
未返回路由	确认该协议支持通过 Composer 提款，且用户持有该头寸代币
余额不足	验证用户的 `fromToken` 余额与请求的 `fromAmount` 相符
授权额度错误	为头寸代币向报价中返回的 `approvalAddress` 设置授权
跨链部分失败	桥接后的代币已到达目标链，但最终的交换可能需要手动完成

有关完整的 status 和 substatus 取值，请参阅交易状态跟踪。

后续步骤

Cross-Chain Patterns

包含桥接的执行模式与状态处理

Deposit Recipes

针对多种协议的端到端存入 recipe

API Parameters

Composer 路由如何被激活和返回

简介

通过 Composer API 集成

通过 LI.FI API 集成

资源

提款

提款的工作原理

同链提款

跨链提款

执行 flow

API Integration

支持 Withdraw 的协议

Supported Protocols

错误处理

后续步骤

Cross-Chain Patterns

Deposit Recipes

API Parameters

​提款的工作原理

​同链提款

​跨链提款

​执行 flow

API Integration

​支持 Withdraw 的协议

Supported Protocols

​错误处理

​后续步骤

Cross-Chain Patterns

Deposit Recipes

API Parameters

提款的工作原理

同链提款

跨链提款

执行 flow

支持 Withdraw 的协议

错误处理

后续步骤