获取 TRON 销毁收入/质押收入
1. 概述与典型用途
返回所选收入类型（销毁或质押）的详细统计数据，包括能量/带宽拆分、各周期汇总、收入占比（Rate）及相对基期的变化率（Ratio）。
- 典型用途：销毁收入与质押收入趋势对比、各收入来源占比分析。
- 何时不要用：查总收入概览用「获取 TRON 协议总收入」。
2. 接口与鉴权
GET /api/consumption/statistic
Base URL 与鉴权见 公共网络与鉴权说明。
3. 请求
字段
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
size | integer | 否 | 2000 | 参与汇总的最新日记录数上限，最大 2000；在 timeType 聚合前截取 |
start | integer | 否 | — | 开始时间，毫秒时间戳 |
end | integer | 否 | — | 结束时间，毫秒时间戳 |
timeType | integer | 否 | 0 | data[] 聚合粒度：0 天、1 月、2 季度、3 年；不改变顶层统计期间 |
type | string | 否 | — | 收入类型：burn 销毁收入、stake 质押收入 |
4. 响应
字段
顶层
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
code | integer | 必返 | 状态码，200 表示成功 | — |
message | string | 必返 | 请求状态描述，成功时为 "request ok" | — |
status | string | 必返 | 状态标识，成功时为 "1" | — |
total | integer | 必返 | data[] 返回的条目数 | — |
lastUpdateSeconds | integer | 必返 | 数据最后更新时间 | 秒时间戳 |
data | array | 必返 | 收入数据列表，见下 | — |
totalIncomeYester | number | 必返 | Yester 本期该类型总收入；统计期间见下表 | TRX |
totalIncomeMonth | number | 必返 | Month 本期该类型总收入；统计期间见下表 | TRX |
totalIncome3Month | number | 必返 | 3Month 本期该类型总收入；统计期间见下表 | TRX |
totalIncomeYear | number | 必返 | Year 本期该类型总收入；统计期间见下表 | TRX |
totalIncomeYesterRatio | number | 必返 | totalIncomeYester 相对基期同项收入的变化率；公式与比较期间见下 | 小数 |
totalIncomeMonthRatio | number | 必返 | totalIncomeMonth 相对基期同项收入的变化率；公式与比较期间见下 | 小数 |
totalIncome3MonthRatio | number | 必返 | totalIncome3Month 相对基期同项收入的变化率；公式与比较期间见下 | 小数 |
totalIncomeYearRatio | number | 必返 | totalIncomeYear 相对基期同项收入的变化率；公式与比较期间见下 | 小数 |
totalNetIncomeYester | number | 必返 | Yester 本期带宽收入；统计期间见下表 | TRX |
totalNetIncomeMonth | number | 必返 | Month 本期带宽收入；统计期间见下表 | TRX |
totalNetIncome3Month | number | 必返 | 3Month 本期带宽收入；统计期间见下表 | TRX |
totalNetIncomeYear | number | 必返 | Year 本期带宽收入；统计期间见下表 | TRX |
totalNetIncomeYesterRate | number | 必返 | 同周期带宽收入占比：totalNetIncomeYester / totalIncomeYester | 0–1 |
totalNetIncomeYesterRatio | number | 必返 | totalNetIncomeYester 相对基期同项收入的变化率；公式与比较期间见下 | 小数 |
totalNetIncomeMonthRate | number | 必返 | 同周期带宽收入占比：totalNetIncomeMonth / totalIncomeMonth | 0–1 |
totalNetIncomeMonthRatio | number | 必返 | totalNetIncomeMonth 相对基期同项收入的变化率；公式与比较期间见下 | 小数 |
totalNetIncome3MonthRate | number | 必返 | 同周期带宽收入占比：totalNetIncome3Month / totalIncome3Month | 0–1 |
totalNetIncome3MonthRatio | number | 必返 | totalNetIncome3Month 相对基期同项收入的变化率；公式与比较期间见下 | 小数 |
totalNetIncomeYearRate | number | 必返 | 同周期带宽收入占比：totalNetIncomeYear / totalIncomeYear | 0–1 |
totalNetIncomeYearRatio | number | 必返 | totalNetIncomeYear 相对基期同项收入的变化率；公式与比较期间见下 | 小数 |
totalEnergyIncomeYester | number | 必返 | Yester 本期能量收入；统计期间见下表 | TRX |
totalEnergyIncomeMonth | number | 必返 | Month 本期能量收入；统计期间见下表 | TRX |
totalEnergyIncome3Month | number | 必返 | 3Month 本期能量收入；统计期间见下表 | TRX |
totalEnergyIncomeYear | number | 必返 | Year 本期能量收入；统计期间见下表 | TRX |
totalEnergyIncomeYesterRate | number | 必返 | 同周期能量收入占比：totalEnergyIncomeYester / totalIncomeYester | 0–1 |
totalEnergyIncomeYesterRatio | number | 必返 | totalEnergyIncomeYester 相对基期同项收入的变化率；公式与比较期间见下 | 小数 |
totalEnergyIncomeMonthRate | number | 必返 | 同周期能量收入占比：totalEnergyIncomeMonth / totalIncomeMonth | 0–1 |
totalEnergyIncomeMonthRatio | number | 必返 | totalEnergyIncomeMonth 相对基期同项收入的变化率；公式与比较期间见下 | 小数 |
totalEnergyIncome3MonthRate | number | 必返 | 同周期能量收入占比：totalEnergyIncome3Month / totalIncome3Month | 0–1 |
totalEnergyIncome3MonthRatio | number | 必返 | totalEnergyIncome3Month 相对基期同项收入的变化率；公式与比较期间见下 | 小数 |
totalEnergyIncomeYearRate | number | 必返 | 同周期能量收入占比：totalEnergyIncomeYear / totalIncomeYear | 0–1 |
totalEnergyIncomeYearRatio | number | 必返 | totalEnergyIncomeYear 相对基期同项收入的变化率；公式与比较期间见下 | 小数 |
Rate、Ratio 与统计期间
type=burn 时，顶层汇总使用 netBurnIncome、energyBurnIncome；type=stake 时使用 netStakeIncome、energyStakeIncome。同周期该类型总收入为带宽收入与能量收入之和；data[] 仍包含两种收入类型。
Rate= 同周期分项收入 ÷ 同周期该类型总收入。总收入小于等于0时返回0。Ratio=（本期收入 − 基期收入）÷ 基期收入；总收入、带宽和能量分别使用各自的本期与基期值。基期小于等于0或无记录时返回0，因此0不能单独证明收入没有变化。- 两类比值均以小数返回，四舍五入保留 6 位小数；显示百分数时乘以
100。Rate为0–1占比；Ratio可为负数或大于1。
令 D 为有效 end 对应的统计日期，T = D + 1 天。当 end 晚于最新数据就绪时间时，接口先将其截到该时间。下表中的 day 为日记录日期，区间端点均不包含。
| 字段后缀 | 本期 | 基期 |
|---|---|---|
Yester | D 当日 | D − 1 天 |
Month | T − 30 天 < day < T | T − 60 天 < day < T − 30 天 |
3Month | T − 90 天 < day < T | T − 180 天 < day < T − 90 天 |
Year | T − 365 天 < day < T | T − 730 天 < day < T − 365 天 |
若 D 当日所选类型总收入小于等于 0 或无记录，全部 Yester 字段改用 D − 1 天，基期改为 D − 2 天。Month、3Month、Year 是滚动区间，当前边界在数据完整时分别包含 29、89、364 个日记录，不代表自然月、自然季度或自然年。
所有顶层汇总只使用 start 到有效 end（含首尾日期）范围内保留的最新 size 个日记录，不会额外补取基期数据。窗口不完整时只对已有记录求和；无记录按 0 计。timeType 只改变 data[] 的聚合粒度，不改变顶层汇总使用的日记录或上述比较区间。
data[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
day | string | 必返 | 统计日期 | YYYY-MM-DD |
trxPriceInUsd | number | 必返 | 当日 TRX 美元价格 | USD |
totalIncome | number | 必返 | 总收入 | TRX |
burnIncome | number | 必返 | 销毁总收入 | TRX |
stakeIncome | number | 必返 | 质押总收入 | TRX |
energyIncome | number | 必返 | 能量总收入 | TRX |
netIncome | number | 必返 | 带宽总收入 | TRX |
energyBurnIncome | number | 必返 | 能量销毁收入 | TRX |
energyStakeIncome | number | 必返 | 能量质押收入 | TRX |
netBurnIncome | number | 必返 | 带宽销毁收入 | TRX |
netStakeIncome | number | 必返 | 带宽质押收入 | TRX |
burnIncomePercent | number | 可选 | 销毁收入占该类型总收入的比例；基于 Greason v5 代码扫描（待补 reproducing sample） | — |
stakeIncomePercent | number | 可选 | 质押收入占该类型总收入的比例；基于 Greason v5 代码扫描（待补 reproducing sample） | — |
energyBurnIncomePercent | number | 可选 | 能量销毁收入占比；基于 Greason v5 代码扫描（待补 reproducing sample） | — |
energyStakeIncomePercent | number | 可选 | 能量质押收入占比；基于 Greason v5 代码扫描（待补 reproducing sample） | — |
netBurnIncomePercent | number | 可选 | 带宽销毁收入占比；基于 Greason v5 代码扫描（待补 reproducing sample） | — |
netStakeIncomePercent | number | 可选 | 带宽质押收入占比；基于 Greason v5 代码扫描（待补 reproducing sample） | — |
5. 错误
HTTP 状态码见 公共错误说明。本接口要点：
size超过 2000 时被静默截断为 2000。- 空结果不是错误：无命中返回
200+data: []，属于正常响应。