核心用法
LI.FI 是跨链流动性聚合协议，通过单一 API 整合 20+ 跨链桥与数十个 DEX，实现任意代币的同链或跨链兑换。核心流程为：
1. 查询支持网络 — /chains 获取当前支持的链列表
2. 检索代币信息 — /tokens 查询指定链上的可用代币
3. 获取报价与交易数据 — /quote 核心接口，返回包含 transactionRequest 的完整路径，可直接提交至钱包执行
4. 高级路由选择 — /advanced/routes 返回多条可选路径，支持按费用、速度、价格影响等维度排序
5. 状态追踪 — /status 监控跨链转账进度
6. 合约调用组合 — /quote/contractCalls（Beta）支持跨链桥接+多步合约调用
关键参数规范
- 链 ID 使用标准数值（如 1=Ethereum, 42161=Arbitrum, 137=Polygon）
- 代币地址使用合约地址或符号（如 ETH、USDC）
- 金额单位为 wei 或最小精度单位
- 默认滑点 1%，默认 deadline 10 分钟
显著优点
- 一站式聚合：无需对接多个桥/DEX，单一 API 覆盖 100+ 网络组合
- 即拿即用：返回的
transactionRequest包含完整的交易对象（to/data/value/gas），可直接通过eth_sendTransaction提交 - 智能路由：自动计算最优路径，支持按 CHEAPEST/FASTEST/SAFEST 排序
- 内置安全预估：返回
toAmountMin保证最低到账金额，滑点保护机制透明 - 灵活的合约调用：支持在目标链执行任意合约调用，适合复杂 DeFi 策略
潜在缺点与局限性
- Beta 功能不稳定：contractCalls 端点明确标注 Beta，存在未预期的 rough edges
- 外部依赖风险：实际执行依赖底层桥和 DEX 合约，若某桥被攻击或暂停会影响完成率
- 价格预估延迟：报价非实时链上价格，极端行情下可能出现较大偏差
- gas 估算局限：跨链交易的 destination gas 预估可能不准确，复杂调用需手动调整
- API Key 限制：公开访问有速率限制，生产环境必须配置
LIFI_API_KEY
适合人群
- 多链钱包/资管应用开发者，需快速集成跨链兑换功能
- DeFi 策略机器人，需程序化执行跨链套利或再平衡
- 需要「桥+swap+合约调用」组合操作的进阶用户
- 追求 UX 简洁性，不愿自行维护多桥对接的产品团队
常规风险
| 风险类型 | 说明 |
|---------|------|
| 智能合约风险 | 底层桥和 DEX 合约若被攻击，资金可能损失 |
| 跨链确认延迟 | 不同链的最终性时间差异可能导致状态同步问题 |
| MEV 与滑点 | 大额交易在目标链可能遭遇夹单，需合理设置滑点 |
| API 可用性 | 服务端故障或限流会影响报价获取，需做好降级 |
| 错误地址风险 | `toAddress` 若填写错误且交易已广播，资金不可追回 |