架构概览
Earn Data API 是一个位于协议数据与你的应用之间的数据聚合层。它负责:- **摄取。**从支持的各个协议的多个数据源获取金库数据。
- **标准化。**将协议特有的格式转换为统一的
NormalizedVault模式。 - **能力解析。**确定哪些金库支持通过 Composer 进行存入和提取。
- **服务。**通过支持过滤、排序和分页的 REST API 暴露标准化后的数据。
数据时效性
Earn Data API 运行一个后台同步流水线,以保持金库数据的最新状态:
这意味着 APY 和 TVL 数据最多滞后 15 分钟,交易能力数据最多滞后 2 分钟。
NormalizedVault 模式
Earn API 中的每个金库都遵循相同的模式,无论它来自哪个协议或数据提供方。这是核心的数据结构:关键字段
交易能力
isTransactional 和 isRedeemable 标志派生自 Composer 的 zap-pack 数据,而非金库本身。它告诉你 LI.FI 基础设施是否能为该金库执行存入和提取操作:
isTransactional: true表示你可以使用 Composer 的报价端点,将该金库的合约地址作为toToken进行存入。isRedeemable: true表示你可以使用 Composer,将该金库的合约地址作为fromToken进行提取。
isTransactional 为 false 的金库,隐藏”存入”按钮。
支持的协议和链
Earn Data API 聚合了来自 20 多个协议、跨越 20 条链的金库。使用发现端点查看当前已索引的内容:GET /v1/chains— 返回至少拥有一个活跃金库的所有链GET /v1/protocols— 返回至少拥有一个活跃金库的所有协议
后续步骤
快速开始
在 5 分钟内完成你的首次 Earn API 调用
API 集成指南
包含所有参数和响应结构的完整端点参考

