> ## Documentation Index
> Fetch the complete documentation index at: https://docs.li.fi/llms.txt
> Use this file to discover all available pages before exploring further.

# 概述

> LI.FI API的基础

<Info>
  **正在构建 AI 代理？** 从我们的[代理集成指南](/agents/overview)开始，以获取必要端点的流畅概览，或使用 [llms.txt](/llms.txt) 获取机器可读文档。
</Info>

## 基础 URL

LI.FI 的 API 基于 REST 原则构建，并通过 HTTPS 提供服务。

所有 API 端点的基础 URL 是：

```javascript theme={"system"}
https://li.quest/v1
```

## 认证

<Note>所有 LI.FI 的 API 都不需要 API 密钥。API 密钥仅用于更高的速率限制</Note>

通过自定义 HTTP 头 `x-lifi-api-key` 和一个 API 密钥执行对 LI.FI API 的认证。如果您正在使用客户端 SDK，您将在构建客户端时设置 API 密钥，然后 SDK 将代表您在每个请求中发送此头。如果直接与 API 集成，您需要自己发送此头，如下所示：

```curl theme={"system"}
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 密钥：

```javascript theme={"system"}
curl --location 'https://li.quest/v1/keys/test' 
--header 'x-lifi-api-key: YOUR_CUSTOM_KEY'
```

<Note> 绝不要在客户端环境中暴露您的 `x-lifi-api-key`，如基于浏览器的 JavaScript 或直接的 Widget 集成中。在客户端使用 API 密钥可能导致未经授权的使用或滥用您的密钥，因为它在浏览器的开发者工具或网络标签页中变得公开可访问。
如果您正在使用 LI.FI Widget，您**不需要传递 API 密钥**。Widget 在不需要前端密钥的情况下安全操作。对于服务器端集成（例如，来自您后端的 SDK 或 API 请求），始终保持您的密钥保密和安全。 </Note>

## 速率限制

速率限制按 IP 计算，不使用 API 密钥，而使用 API 密钥进行认证请求时则按 API 密钥计算。

请参考[速率限制和 API 认证](/api-reference/rate-limits)页面。

## 错误消息

错误由三部分组成：

1. HTTP 错误代码
2. LI.FI 错误代码
3. 错误消息

特定的错误代码和消息定义在[错误代码](/api-reference/error-codes)页面上

<Info>
  **寻找一键 DeFi 操作？** 使用 [Composer](/composer/overview) 进行存款到金库、质押和借贷 — 所有这些都通过相同的 `/quote` 端点完成。将 `toToken` 设置为金库代币地址，Composer 会处理其余部分。参见 [Composer API 参数](/composer/reference/api-parameters)。
</Info>