核心用法
LI.FI 是一个聚合型跨链流动性协议,通过统一 API 整合主流跨链桥(如 Stargate、Across、Hop)和 DEX(如 Uniswap、Curve),实现最优路由发现与交易执行。核心工作流分为三步:
1. 元数据获取:调用 /v1/chains、/v1/tokens、/v1/tools 获取支持的链、代币及桥接/DEX 白名单,用于输入校验
2. 路由报价:使用 GET /v1/quote 获取单条最优路由,或 POST /v1/advanced/routes 获取多方案对比(支持 FASTEST/CHEAPEST 排序策略)
3. 交易执行:直接采用返回的 transactionRequest(含 to/data/value/gas 参数)提交链上交易,无需手动编码
关键参数要求:金额须转换为代币最小单位(decimals 处理),slippage 以 0-1 小数表示(如 0.005 = 0.5%)。支持高级功能如目的地合约调用(quote/contractCalls)和 CEX 式存款地址(deposit/address)。
显著优点
- 深度聚合:覆盖 20+ EVM 链及主流 L2,单次查询对比多桥多 DEX 组合路由
- 执行标准化:返回可直接签名的交易请求,消除手动 ABI 编码风险
- 灵活策略:支持桥接/DEX 白名单/黑名单、滑点偏好、MEV 防护策略等精细化控制
- 状态追踪:内置
/v1/status端点实现跨链交易全生命周期监控 - 生产就绪:提供 API Key 分级(公开/认证),认证用户享受更高频率限额
潜在局限
- 中心化依赖:路由计算依赖 LI.FI 后端服务,单点故障或 API 变更可能影响可用性
- 公开接口限制:无 API Key 时存在速率限制,不适合高频量化场景
- 智能合约风险:实际资金流转经过聚合的多方桥接合约,需承担组合式合约漏洞风险
- 链覆盖盲区:非 EVM 链(如 Solana、比特币原生)支持有限或缺失
- 价格冲击:大额交易可能因底层 DEX 流动性不足产生显著滑点,需关注
maxPriceImpact参数
适合人群
- 多链钱包/DeFi 聚合器开发者(需快速接入跨链兑换)
- 机构或高净值用户执行大额跨链资产迁移
- 链抽象(Chain Abstraction)应用构建者,意图简化用户跨链交互
- 需要程序化访问桥接+DEX 组合路由的交易策略团队
常规风险
- API Key 泄露:
LIFI_API_KEY暴露可能导致配额耗尽或追踪数据污染 - 交易请求篡改:严禁修改返回的
transactionRequest.data,任何手动编码均可能导致资金损失 - 前端欺诈:钓鱼网站可能伪造 LI.FI 接口,用户需核验域名
li.quest - 滑点攻击:极端行情下实际执行价可能偏离报价,建议设置合理 slippage 阈值
- Gas 波动:跨链消息传递受目标链拥堵影响,实际到账时间存在不确定性