跳转到主要内容
正在构建 AI 代理? 从我们的代理集成指南开始,以获取必要端点的流畅概览,或使用 llms.txt 获取机器可读文档。

基础 URL

LI.FI 的 API 基于 REST 原则构建,并通过 HTTPS 提供服务。 所有 API 端点的基础 URL 是:
https://li.quest/v1

认证

所有 LI.FI 的 API 都不需要 API 密钥。API 密钥仅用于更高的速率限制
通过自定义 HTTP 头 x-lifi-api-key 和一个 API 密钥执行对 LI.FI API 的认证。如果您正在使用客户端 SDK,您将在构建客户端时设置 API 密钥,然后 SDK 将代表您在每个请求中发送此头。如果直接与 API 集成,您需要自己发送此头,如下所示:
curl --location 'https://li.quest/v1/quote?fromChain=100&fromAmount=1000000&fromToken=0x4ecaba5870353805a9f068101a40e0f32ed605c6&fromAddress=0x552008c0f6870c2f77e5cC1d2eb9bdff03e30Ea0&toChain=137&toToken=0x2791bca1f2de4661ed88a30c99a7a9449aa84174&slippage=0.03' \
--header 'x-lifi-api-key: YOUR_CUSTOM_KEY'
可以使用以下端点测试 API 密钥:
curl --location 'https://li.quest/v1/keys/test' 
--header 'x-lifi-api-key: YOUR_CUSTOM_KEY'
绝不要在客户端环境中暴露您的 x-lifi-api-key,如基于浏览器的 JavaScript 或直接的 Widget 集成中。在客户端使用 API 密钥可能导致未经授权的使用或滥用您的密钥,因为它在浏览器的开发者工具或网络标签页中变得公开可访问。 如果您正在使用 LI.FI Widget,您不需要传递 API 密钥。Widget 在不需要前端密钥的情况下安全操作。对于服务器端集成(例如,来自您后端的 SDK 或 API 请求),始终保持您的密钥保密和安全。

速率限制

速率限制按 IP 计算,不使用 API 密钥,而使用 API 密钥进行认证请求时则按 API 密钥计算。 请参考速率限制和 API 认证页面。

错误消息

错误由三部分组成:
  1. HTTP 错误代码
  2. LI.FI 错误代码
  3. 错误消息
特定的错误代码和消息定义在错误代码页面上
寻找一键 DeFi 操作? 使用 Composer 进行存款到金库、质押和借贷 — 所有这些都通过相同的 /quote 端点完成。将 toToken 设置为金库代币地址,Composer 会处理其余部分。参见 Composer API 参数