核心用法
LI.FI 是跨链流动性聚合基础设施,通过单一 API 整合 27 座桥(Across、Stargate、Hop 等)与 31 个 DEX(Uniswap、1inch、Curve 等),覆盖 EVM、Solana、Bitcoin、Sui 等 58+ 条链。核心工作流为:
1. 链/代币发现:GET /chains 与 GET /tokens 获取支持的链 ID 和代币元数据(地址、精度、USD 价格)。
2. 路由报价:GET /quote 返回单条最优路径,含 transactionRequest(可直接签名);POST /advanced/routes 返回多条路径供对比。
3. 状态追踪:GET /status 通过源链 txHash 查询跨链进度,状态包括 PENDING/DONE/FAILED 及子状态 COMPLETED/PARTIAL/REFUNDED。
4. 交易执行:配合 Openclast 等钱包,将 transactionRequest 字段(to/data/value/gasLimit 等)透传至 wallet_contract_call → wallet_approve 完成发送。
显著优点
- 深度聚合:自动选择最快或最便宜路径,支持同链 swap 与跨链 bridge 的无缝组合。
- 生产级可靠:API 提供 60 秒报价缓存、滑点保护(
toAmountMin)、价格影响上限(maxPriceImpact)。 - 开发者友好:OpenAPI 规范完备,LLM 可直接消费
llms.txt文档;支持可选 API Key 提升限流。
潜在局限
- 时效性敏感:报价约 60 秒过期,高频场景需重新获取。
- 精度转换陷阱:
fromAmount须为最小单位(如 USDC 6 位小数),易因精度错误导致金额偏差。 - 桥接风险:依赖第三方桥合约,若桥合约被攻击或流动性枯竭,资金可能锁定或损失(历史行业事件)。
- Gas 波动:跨链交易涉及源链与目的链两次 Gas 成本,网络拥堵时实际成本可能超预估。
适合人群
- 多链 DeFi 用户、跨链套利者、意图驱动钱包开发者、AI Agent 构建者。
常规风险
- 智能合约风险:桥合约与 DEX 合约漏洞。
- 滑点与 MEV:极端行情下实际接收额可能低于
toAmountMin(虽概率低)。 - API Key 泄露:
LIFI_API_KEY若硬编码或泄露,可能遭滥用导致限流或费用损失。