Skip to main content
本页面介绍 Earn Data API 如何跨协议聚合金库数据,将其标准化为统一的模式,并保持数据的时效性。

架构概览

Earn Data API 是一个位于协议数据与你的应用之间的数据聚合层。它负责:
  1. **摄取。**从支持的各个协议的多个数据源获取金库数据。
  2. **标准化。**将协议特有的格式转换为统一的 NormalizedVault 模式。
  3. **能力解析。**确定哪些金库支持通过 Composer 进行存入和提取。
  4. **服务。**通过支持过滤、排序和分页的 REST API 暴露标准化后的数据。

数据时效性

Earn Data API 运行一个后台同步流水线,以保持金库数据的最新状态: 这意味着 APY 和 TVL 数据最多滞后 15 分钟,交易能力数据最多滞后 2 分钟。

NormalizedVault 模式

Earn API 中的每个金库都遵循相同的模式,无论它来自哪个协议或数据提供方。这是核心的数据结构:

关键字段

交易能力

isTransactionalisRedeemable 标志派生自 Composer 的 zap-pack 数据,而非金库本身。它告诉你 LI.FI 基础设施是否能为该金库执行存入和提取操作:
  • isTransactional: true 表示你可以使用 Composer 的报价端点,将该金库的合约地址作为 toToken 进行存入。
  • isRedeemable: true 表示你可以使用 Composer,将该金库的合约地址作为 fromToken 进行提取。
请使用这些标志来控制你的 UI。例如,对于 isTransactionalfalse 的金库,隐藏”存入”按钮。

支持的协议和链

Earn Data API 聚合了来自 20 多个协议、跨越 20 条链的金库。使用发现端点查看当前已索引的内容:
  • GET /v1/chains — 返回至少拥有一个活跃金库的所有链
  • GET /v1/protocols — 返回至少拥有一个活跃金库的所有协议
这些端点反映了来自同步流水线的实时数据,并将随着新协议和新链的接入而增长。

后续步骤

快速开始

在 5 分钟内完成你的首次 Earn API 调用

API 集成指南

包含所有参数和响应结构的完整端点参考