获取 TRON 协议总收入
1. 概述与典型用途
返回 TRON 协议收入的完整明细——包括销毁收入、质押收入、能量/带宽拆分、收盘 TRX 价格以及环比变化率，支持配置时间粒度。
- 典型用途：协议收入趋势分析、各收入来源占比分析、收入日报/月报。
- 何时不要用：仅查销毁或质押收入的细分数据用「获取 TRON 销毁收入/质押收入」。
2. 接口与鉴权
GET /api/turnover/new
Base URL 与鉴权见 公共网络与鉴权说明。
3. 请求
字段
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
size | integer | 否 | 2000 | 每页条目数，最大 2000 |
start | integer | 否 | — | 开始时间，毫秒时间戳 |
end | integer | 否 | — | 结束时间，毫秒时间戳 |
timeType | integer | 否 | 0 | 查询粒度：0 天、1 月、2 季度、3 年 |
4. 响应
字段
顶层
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
code | integer | 必返 | 状态码，200 表示成功 | — |
message | string | 必返 | 请求状态描述，成功时为 "request ok" | — |
status | string | 必返 | 状态标识，成功时为 "1" | — |
total | integer | 必返 | data[] 返回的条目数 | — |
lastUpdateSeconds | integer | 必返 | 数据最后更新时间 | 秒时间戳 |
data | array | 必返 | 收入数据列表，见下 | — |
totalIncomeYester | number | 必返 | 昨日总收入 | TRX |
totalIncomeYesterRate | number | 必返 | 日环比总收入变化率 | — |
totalIncomeMonth | string | 必返 | 上月总收入 | TRX |
totalIncomeMonthRate | number | 必返 | 月环比总收入变化率 | — |
totalIncome3Month | string | 必返 | 上季度总收入 | TRX |
totalIncome3MonthRate | number | 必返 | 季度环比总收入变化率 | — |
totalIncomeYear | string | 必返 | 去年总收入 | TRX |
totalIncomeYearRate | number | 必返 | 年同比总收入变化率 | — |
data[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
day | string | 必返 | 统计日期 | YYYY-MM-DD |
trxClosePrice | string | 必返 | 当日 TRX 收盘价 | USD |
totalIncome | number | 必返 | 总收入 | TRX，float |
burnIncome | number | 必返 | 销毁总收入 | TRX，float |
burnIncomePercent | string | 必返 | 销毁收入占总收入比例 | — |
stakeIncome | number | 必返 | 质押总收入 | TRX，float |
stakeIncomePercent | string | 必返 | 质押收入占总收入比例 | — |
energyIncome | number | 必返 | 能量总收入 | TRX，float |
netIncome | number | 必返 | 带宽总收入 | TRX，float |
energyBurnIncome | number | 必返 | 能量销毁收入 | TRX，float |
energyBurnIncomePercent | string | 必返 | 能量销毁占销毁总收入比例 | — |
energyBurnIncomePercentInTotal | string | 必返 | 能量销毁占总收入比例 | — |
energyStakeIncome | number | 必返 | 能量质押收入 | TRX，float |
energyStakeIncomePercent | string | 必返 | 能量质押占质押总收入比例 | — |
energyStakeIncomePercentInTotal | string | 必返 | 能量质押占总收入比例 | — |
netBurnIncome | number | 必返 | 带宽销毁收入 | TRX，float |
netBurnIncomePercent | string | 必返 | 带宽销毁占销毁总收入比例 | — |
netBurnIncomePercentInTotal | string | 必返 | 带宽销毁占总收入比例 | — |
netStakeIncome | number | 必返 | 带宽质押收入 | TRX，float |
netStakeIncomePercent | string | 必返 | 带宽质押占质押总收入比例 | — |
netStakeIncomePercentInTotal | string | 必返 | 带宽质押占总收入比例 | — |
5. 错误
HTTP 状态码见 公共错误说明。本接口要点：
size超过 2000 时被静默截断为 2000。- 空结果不是错误：无命中返回
200+data: []，属于正常响应。
最后更新于: