Skip to main content
正在构建 AI 智能体? 请从我们的智能体集成指南开始,快速了解必需的端点,或使用 llms.txt 获取机器可读文档。

基础 URL

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

认证

所有 LI.FI API 都不需要 API 密钥。API 密钥仅在需要更高速率限制时才用得上
对 LI.FI API 的认证通过自定义 HTTP 头 x-lifi-api-key 携带 API 密钥来完成。如果你使用客户端 SDK,只需在构造客户端时设置 API 密钥,之后 SDK 会代表你在每个请求中发送该请求头。如果你直接与 API 集成,则需要像下面这样自行发送该请求头:
可以使用以下端点测试 API 密钥:
切勿在客户端环境(如基于浏览器的 JavaScript 或直接的 Widget 集成)中暴露你的 x-lifi-api-key。在客户端使用 API 密钥可能导致密钥被未经授权地使用或滥用,因为它会在浏览器的开发者工具或网络标签页中公开可见。 如果你使用 LI.FI Widget,则无需传递 API 密钥。Widget 在前端无需密钥即可安全运行。对于服务器端集成(例如来自你后端的 SDK 或 API 请求),请始终将密钥保密并妥善保管。

速率限制

无 API 密钥的请求按 IP 计算速率限制,携带 API 密钥的认证请求则按 API 密钥计算。 请参阅速率限制和 API 认证页面。

错误消息

错误由三部分组成:
  1. HTTP 错误码
  2. LI.FI 错误码
  3. 错误消息
具体的错误码和消息定义在错误码页面
需要一键式 DeFi 操作? 使用 Composer 存入金库、质押和借贷,全部通过同一个 /quote 端点完成。将 toToken 设置为金库代币地址,Composer 会处理其余部分。参见 Composer API 参数