获取 DeFi TVL 数据
1. 概述与典型用途
返回 TRON 链上 DeFi 协议的 TVL(总锁仓量)统计及各项目明细。
- 典型用途:监控 TRON DeFi 生态 TVL 变化、分析各协议锁仓量排名、评估 DeFi 发展趋势。
- 何时不要用:查代币总价值用「获取代币链上总价值(TVC)」;查综合统计用「获取 TRON 统计数据」。
2. 接口与鉴权
GET /api/defiTvl
Base URL 与鉴权见 公共网络与鉴权说明。
3. 请求
字段
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
type | string | 否 | — | 设置为 tvlline 时,结果中包含 tvlLine 数组数据 |
startTime | integer | 否 | 7 天前 | 开始时间,精确到秒 |
endTime | integer | 否 | 当前时间 | 结束时间,精确到秒 |
project | string | 否 | 全部 | 指定项目:SUN、JustLend、JustStable、JustCryptos 或 JustSwap |
show | string | 否 | — | 取值 day 时,响应额外返回 tvlLineByDay 数组 |
4. 响应
字段
顶层
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
total | number | 必返 | DeFi TVL 总量 | USD |
tvlLine | array | 可选 | TVL 趋势数据(仅 type=tvlline),含 t(秒时间戳 string)和 v(number,USD) | — |
tvlLineByDay | array | 可选 | 按天的 TVL 趋势数据(仅 show=day),含 t(秒时间戳 string)和 v(number,USD) | — |
projects | array | 必返 | 各 DeFi 项目明细,见下 | — |
projects[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
project | string | 必返 | 项目名称 | — |
logo | string | 必返 | 项目图标 URL | — |
type | string | 必返 | 项目类型(如 Governance、Lending) | — |
vip | string | 可选 | 是否为 VIP 项目 | — |
locked | number | 必返 | 锁仓量 | USD |
url | string | 必返 | 项目链接 | — |
gain | number | 必返 | 锁仓量变化率 | 小数 |
5. 错误
HTTP 状态码见 公共错误说明。本接口要点:
- 空结果不是错误:无数据返回
200+projects: [],属于正常响应。
最后更新于: