> ## 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 Earn？

> 启动 Earn 产品的最快方式。通过内置的跨链执行实现一键存入，接入来自 60 多条链上 20 多个协议的收益机会。

LI.FI Earn 是在任何钱包、应用或平台中启动 Earn 产品并进行变现的最快方式。通过单次 API 集成，即可接入来自 60 多条链上 20 多个协议的市场领先收益机会，无需具备内部 DeFi 专业知识，也无需管理底层执行的复杂性。

<Note>
  \*\*两个层次，一个产品。\*\*LI.FI Earn 将用于金库发现和投资组合追踪的 **Earn Data API** 与用于链上执行的 **Composer** 相结合。二者共同让你在单次集成中，跨任意链呈现收益机会并执行存入。
</Note>

***

## 为什么使用 Earn？

* \*\*接入 20 多个协议。\*\*通过单个 API 呈现来自 Aave、Morpho、Euler、Pendle 等协议的收益机会。无需逐个集成每个协议。
* \*\*标准化数据。\*\*无论底层协议如何，每个金库都遵循相同的模式。无需数据整理即可比较 APY、TVL 和代币构成。
* \*\*一键存入。\*\*Composer 在单笔交易中处理交换、桥接和存入。用户可以从任意链上的任意代币进入任意金库。
* \*\*投资组合追踪。\*\*以标准化格式检索用户在所有支持协议中的全部持仓、余额和收益。
* \*\*完全掌控。\*\*你决定呈现哪些协议、如何构建产品以及展示哪些披露信息。LI.FI 负责基础设施。
* \*\*内置变现。\*\*配置收益分成以对金库集成进行变现。

***

## 两个层次

LI.FI Earn 为构建 Earn 产品提供了完整的基础设施，从发现收益机会到执行存入并追踪持仓。

| 层次                                 | Base URL             | 功能                                 |
| ---------------------------------- | -------------------- | ---------------------------------- |
| **Earn Data API**                  | `https://earn.li.fi` | 金库发现、标准化元数据、APY 和 TVL 分析、投资组合持仓和收益 |
| **[Composer](/composer/overview)** | `https://li.quest`   | 链上执行：一键存入、跨链流程、任意代币到金库的交易          |

一个典型的集成流程：

1. \*\*发现。\*\*使用 Earn Data API 列出金库，按链/资产/协议过滤，并按 APY 或 TVL 排序。
2. \*\*展示。\*\*在你的 UI 中展示金库详情（APY 明细、TVL、底层代币）。
3. \*\*存入。\*\*当用户想要存入时，将金库的 LP 代币地址传递给 Composer 的 `GET /v1/quote` 端点。Composer 在单笔交易中处理交换、桥接和存入。
4. \*\*追踪。\*\*使用 Earn Data API 的投资组合端点展示用户在各金库中的持仓和收益。

***

## Earn 适合谁？

<AccordionGroup>
  <Accordion title="钱包与 DeFi 平台">
    在你的应用中构建一个收益市场。向用户展示各协议中可用的最佳收益，
    让他们比较各种选项，并通过 Composer 实现一键存入。使用投资组合端点
    展示他们的活跃持仓和收益。
  </Accordion>

  <Accordion title="投资组合追踪器与仪表盘">
    跨协议聚合用户的 DeFi 持仓，无需逐个集成每个协议。
    Earn Data API 将持仓数据标准化为
    一致的格式。
  </Accordion>

  <Accordion title="DeFi 聚合器">
    将 Earn Data API 作为你的金库数据层。按链、资产或
    协议过滤，按收益或 TVL 排序，并使用 Composer 执行。
  </Accordion>
</AccordionGroup>

***

## 试一试

列出 Base 上按 APY 排序的顶级 USDC 金库：

<CodeGroup>
  ```bash curl theme={"system"}
  curl -X GET 'https://earn.li.fi/v1/vaults?chainId=8453&asset=USDC&sortBy=apy&limit=5'
  ```

  ```ts TypeScript theme={"system"}
  const response = await fetch(
    'https://earn.li.fi/v1/vaults?chainId=8453&asset=USDC&sortBy=apy&limit=5'
  );
  const { data, total } = await response.json();

  data.forEach((vault) => {
    console.log(`${vault.name}: ${(vault.analytics.apy.total * 100).toFixed(2)}% APY`);
  });
  ```
</CodeGroup>

请参阅[快速开始](/earn/quickstart)，了解包含金库选择、存入和持仓追踪在内的完整分步演练。

***

## 当前限制

* \*\*数据覆盖范围。\*\*金库数据反映了 LI.FI 同步流水线已索引的内容。并非每个支持协议的所有金库都保证会出现。
* \*\*仅可通过 Composer 存入。\*\*Earn Data API 仅负责发现和追踪。链上执行需要单独的 [Composer API](/composer/overview)。

***

## 后续步骤

<CardGroup cols={2}>
  <Card title="快速开始" icon="rocket" href="/earn/quickstart">
    在 5 分钟内完成你的首次 API 调用
  </Card>

  <Card title="Earn 的工作原理" icon="diagram-project" href="/earn/how-it-works">
    了解数据流水线、NormalizedVault 模式以及数据如何保持
    最新
  </Card>

  <Card title="API 集成指南" icon="code" href="/earn/guides/api-integration">
    包含参数和响应示例的完整端点参考
  </Card>

  <Card title="发现与存入配方" icon="book" href="/earn/recipes/discover-and-deposit">
    端到端配方：找到顶级金库，然后通过 Composer 存入
  </Card>
</CardGroup>